Virtual Account Assigned

This template will be triggered when the virtual account has been assigned to the Customer in 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 in cases of asynchronous assignment of virtual accounts. In the latter case, the webhook introduced will notify Clients once the virtual accounts have been assigned.

https://<customerHost:Port>/webhook

Headers

FieldDescription
Content-Typeapplication/json

Example Request

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
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
currencyCode3-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 1st routing code type. See the Examples of Routing Codes.String
routingCodeValue1The routing code value for routingCodeType1String
routingCodeType2The 2nd 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