Skip to Main Content
Riverty Docs
riverty logo Docs

Chargeback Received Notification

Key benefits for you

The Chargeback Received notification is triggered when a payment made by an end-customer is either declined, canceled, or a chargeback is received. This can occur through various payment methods such as credit cards, direct debit, or PayPal. When a chargeback is identified through the PSP response, settlement files, or bank account statements, this notification informs you of the chargeback details

This notification can be utilized for various business purposes:

  • Chargeback Monitoring: Get updates when an end-customer fails to complete a payment or initiates a chargeback, allowing you to take immediate action.
  • Subscription Management: Use this information to automatically pause subscriptions or other services depending on the payment.
  • Customer Service Support: Track chargebacks and payment issues to give your Customer Service teams the information they need to answer end-customer calls.

Setting up the notification

To register to this notification, please look in the general notifications-page using accounting/chargebackReceived

The follow-up processes depend on what you want to do with the data:

  • Save the data for your CRM Tool or My Account Pages
  • End processes that depend on a successfull payment

Technical Details

Trigger Events:

The Chargeback Received notification is triggered under the following scenarios:

  • A payment is declined (e.g., credit card payment declined by the issuer).
  • A direct debit transaction is charged back (the fee can either be charged directly to the end-customer or a fixed fee can be defined)
  • A credit card payment is charged back, initiated by the customer

Example Credit Card Chargeback:

{
  "id": "Chargeback-1004-0F5CAC7922F21EEF9DD0B76602D3007C",
  "type": "accounting/chargebackReceived",
  "parameters": {
    "amount": 452.0,
    "businessCode": "1004",
    "companyCode": "1004",
    "currency": "EUR",
    "customerNumber": "CN1199006753",
    "invoiceReference": "",
    "orderReference": "ORD-9005969",
    "transactionId": "Chargeback-1004-0F5CAC7922F21EEF9DR4B76602D3007C",
    "type": "CREDIT_CARD_CHARGEBACK"
  },
  "timestamp": "2024-09-19T12:50:22.6140292Z"
}

Example Direct Debit Chargeback:

{
  "id": "Chargeback-1004-0F5CAC7922F21EEF9DD0B76602D3007C",
  "type": "accounting/chargebackReceived",
  "parameters": {
    "amount": 300.0,
    "businessCode": "1004",
    "companyCode": "1004",
    "currency": "EUR",
    "customerNumber": "GC9699006753",
    "invoiceReference": "INV20240919",
    "orderReference": "9689005969",
    "transactionId": "Chargeback-1004-0F5CAC7922F21EEF9DD0B76602D3007C",
    "type": "DIRECT_DEBIT_CHARGEBACK_FIXED_FEE"
  },
  "timestamp": "2024-09-19T12:50:22.6140292Z"
}

Field description

Please look here for the details of the Chargeback Received Notification.