Direct Debit Transaction Chargeback

This template will be triggered when Nium claims the amount back from the customer’s wallet after a chargeback is raised.




Example Request:

curl --location --request POST 'https://<customerHost:Port>/webhook' \
-H 'content-type: application/json' \
-d '{
    "transactionCurrency": "USD",
    "routingValue": "011401533",
    "systemReferenceNumber": "FW4086323985R",
    "debitReason": "R01",
    "walletHashId": "7a73f776-50f2-428c-9615-0c507ffcb59e",
    "transactionDate": "2023-03-30 12:28:24.879",
    "accountNumber": "XXXXXXXXXXXX1111",
    "customerHashId": "017d7c23-c9bc-49db-9612-8748e22c4fe6",
    "walletBalance": "88.24",
    "routingType": "ACH CODE",
    "beneficiaryName": "Albertha Bobbeth Charleson",
    "transactionAmount": "52.00",
    "debitCode": "ACH_REVERSAL",
    "clientHashId": "c3bcbcc0-07a9-4bdd-b8c8-de62c52bda83"

Request Body:

clientHashIdUnique client identifier generated and shared before API handshake.UUID
customerHashIdUnique customer identifier generated on customer creation.UUID
walletHashIdUnique wallet identifier generated simultaneously with customer creation.UUID
transactionCurrencyThis field contains the 3-letter ISO-4217 transaction currency code.String
transactionAmountThis field contains the transaction amount.String
systemReferenceNumberThe unique, system generated reference number for the transaction.String
beneficiaryNameName of the beneficiary.String
transactionDateDate when Fund Wallet was called.String
accountNumberThis field contains the masked account number.String
routingValueThis field contains the bank code.String
routingTypeThis field contains the routing type of ACH Code or SORT Code depending on geography.String
templateThe value for this field is **DIRECT_DEBIT_TRANSACTION_CHARGEBACK_SETTLED_WEBHOOK**String
debitCodeThis field contains the debit code of RETURN or REVERSAL.String
debitReasonThis field contains the R-code for US and similar code for UK/EU.String
walletBalanceThis field shows the balance after the debit.String