Virtual Account Assigned

This template is triggered when a virtual account has been assigned to the customer in an asynchronous flow.

Unlike in the synchronous assignment of virtual accounts, which are returned in the response of the respective APIs, clients do not receive certain virtual accounts immediately in the response of the APIs. This happens in cases of an asynchronous assignment of virtual accounts. In the latter case, the webhook introduced notifies the clients once the virtual accounts have been assigned.

https://<customerHost:Port>/webhook

Header

FieldDescription
Content-Typeapplication/json

Request example

curl --location --request POST 'https://<customerHost:Port>/webhook' \
-H 'content-type: application/json' \
-d '{
       "clientHashId":"845f4c18-546a-4e14-b8d4-fc26179e56da",
       "customerHashId":"993bac0f-31e9-471b-93e9-50d90994a13c",
       "walletHashId":"cc90e8d0-c993-4ea7-9169-ad6662a4d60d",
       "currencyCode":"GBP",
       "uniquePaymentId":"8874746216",
       "uniquePayerId":"8675116",
       "fullBankName":"JPMorgan Chase Bank N.A., London",
       "routingCodeType1":"BIC",
       "routingCodeValue1":"CHASGB2L",
       "routingCodeType2":"",
       "routingCodeValue2":"",
       "accountName":"NIUM FINTECH LIMITED",
       "accountType":"GLOBAL",
       "bankAddress":"25 Bank Street Canary Wharf, London, E14 5JP, United Kingdom",
       "template":"VIRTUAL_ACCOUNT_ASSIGNED_WEBHOOK"
}'

Request body

FieldDescriptionType
clientHashIdThe unique client identifier generated and shared before API handshake.UUID
customerHashIdThe unique customer identifier generated on customer creation.UUID
walletHashIdThe unique wallet identifier generated simultaneously with customer creation.UUID
currencyCodeThe three-letter ISO-4217 currency code.String
uniquePaymentIdThe unique payment ID.String
uniquePayerIdThe unique payer ID.String
fullBankNameThe complete name of the bank for the virtual account.String
routingCodeType1The first routing code type. See the Examples of Routing Codes.String
routingCodeValue1The routing code value for routingCodeType1String
routingCodeType2The second routing code type. See the Examples of Routing Codes.String
routingCodeValue2The routing code value for routingCodeType2String
accountNameThe account name to be mentioned while doing a fund transfer.String
accountTypeThe account type. The possible values are:
LOCAL
GLOBAL
LOCAL+GLOBAL
String
bankAddressThe bank address.String
templateThe value for this field is VIRTUAL_ACCOUNT_ASSIGNED_WEBHOOK.String