Remit Transaction Rejected

This webhook is triggered when a payout request made via the Transfers API fails. Rejection may occur due to reasons such as incorrect configuration, insufficient wallet balance, or exceeding predefined transaction limits.

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": "REMIT_TRANSACTION_REJECTED_WEBHOOK",
    "reason": "INSUFFICIENT_FUNDS",
    "transactionCurrency": "AUD",
    "reasonDescription": "Insufficient funds in wallet",
    "billingAmount": "100000.00",
    "beneficiaryAccountNumber": "xxxxx3852",
    "systemReferenceNumber": "RT9834178569",
    "externalId": "",
    "walletHashId": "d396c4d4-dd23-4cc4-a5c0-d0a1d9f151d2",
    "tags": [],
    "customerHashId": "1027d7c5-2577-4e1e-b462-c15728fe16e8",
    "exchangeRate": "1.567095900",
    "billingCurrency": "USD",
    "beneficiaryName": "Alvin Roob III",
    "beneficiaryBankName": "BANKWEST (A DIVISION OF COMMONWEALTH BANK OF AUSTRALIA)",
    "transactionAmount": "156709.59",
    "clientHashId": "86528edd-55a3-4a2c-9939-144ed9be43ef"
}'

TO-DO

Request body

Field	Description	Type
clientHashId	The unique client identifier that's provided during onboarding	UUID
customerHashId	The unique customer identifier that's generated during customer creation.	UUID
reason	Code indicating the reason for transaction rejection. Possible value: INSUFFICIENT_FUNDS.	String
reasonDescription	Text description elaborating the reason for rejection.	String
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 is the destination amount that the beneficiary receives.	String
systemReferenceNumber	This is a unique system reference number that's generated by the system for the transaction.	String
exchangeRate	The exchange rate from the source currency to the destination currency, for example, 1 USD is equivalent to 1.392 SGD.	String
beneficiaryName	This field contains the name of the beneficiary.	String
beneficiaryAccountNumber	This field contains the bank account number of the beneficiary.	String
beneficiaryBankName	This field contains the bank name of the beneficiary.	String
billingCurrency	This field contains the three-letter ISO-4217 currency code.	String
billingAmount	This field contains the source amount in case of remittance.	String
template	The value for this field is REMIT_TRANSACTION_REJECTED_WEBHOOK.	String
externalId	A unique identifier provided by you to track requests or transactions. Refer to externalId field of Transfers API.	String