Direct Debit Transaction Return

This template is triggered when a return/reversal request is received for a Direct Debit transaction.

https://<customerHost:Port>/webhook

Header

Field	Description
`Content-Type`	application/json

Request example

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

Request body

Fields	Description	Type
`clientHashId`	The unique client identifier that's generated and shared before API handshake.	UUID
`customerHashId`	The unique customer identifier that's generated on customer creation.	UUID
`walletHashId`	The unique wallet identifier that's generated simultaneously with customer creation.	UUID
`transactionCurrency`	This field contains the three-letter ISO-4217 transaction currency code.	String
`transactionAmount`	This field contains the transaction amount.	String
`systemReferenceNumber`	The unique system-generated reference number for the transaction.	String
`beneficiaryName`	The name of the beneficiary.	String
`transactionDate`	The date when the Fund Wallet is called.	String
`accountNumber`	This field contains the masked account number.	String
`routingValue`	This field contains the bank code.	String
`routingType`	This field contains the routing type of the ACH code or SORT code depending on the geography.	String
`template`	The value for this field is `DIRECT_DEBIT_TRANSACTION_RETURN_WEBHOOK`.	String
`debitCode`	This field contains the debit code of `RETURN` or `REVERSAL`.	String
`debitReason`	This field contains the R-code for the US and a similar code for UK/EU.	String
`walletBalance`	This field shows the balance after the debit.	String