{
"amount": "4.50",
"currency": "GBP",
"cmsProfileId": 123,
"event": "INTERNATIONAL_PAYMENT_COLLECTED",
"paymentTime": "2022-12-29 13:42:54",
"referenceId": 63,
"remarks": "",
"remitterAccount": "1223456789",
"remitterAddress": "Dummy Address",
"remitterBic": "TRWIBEB1XXX",
"remitterCountry": "GB",
"remitterName": "Dummy Sender",
"remitterRoutingCode": "TLG0123",
"signature": "QfbNhM7BeySY7xoTygQZC86Ihm4Ojx4pJVYTF14Sy9Y=",
"status": "COMPLETED",
"utr": "5347f52a-9851-4fe9-8618-32eb085590ce",
"updatedStatusTime": "2022-12-29 13:50:35",
"vAccountId": "97836",
"vAccountNumber": "GB38TCCL12345687997836"
}
Field Description Example amount The foreign currency amount sent 4.50 currency Three character ISO code. View list of supported currencies here . GBP cmsProfileId Merchant identifier 123 event Webhook event INTERNATIONAL_AMOUNT_COLLECTED paymentTime The time at which the payment was initiated. 2022-12-29 13:42:54 referenceId Cashfree Payments transaction identifier 63 remarks Remarks passed by the sender. Sample Remark remitterAccount The bank account number of the person who sends the money. 1223456789 remitterAddress The address of the person who sends the money. Dummy Address remitterBic Bank identifier code for the remitter. TRWIBEB1XXX remitterCountry The country from which the money is sent. GB remitterName The name of the remitter who is sending the money. John Doe remitterRoutingCode The routing code of the remitter's bank. TLG0123 signature Webhook signature QfbNhM7BeySY7xoTygQZC86Ihm4Ojx4pJVYTF14Sy9Y= status Status of FCY (foreign currency leg) of transaction. COMPLETED, FAILED, PENDING updatedStatusTime The time of the last status update. 2022-12-29 13:50:35 vAccountId Identifier of the virtual account. 97836 vAccountNumber Account number to which the payment was done. GB38TCCL12345687997836
{
"amount": "4.50",
"cmsProfileId": 123,
"currency": "GBP",
"event": "INR_SETTLEMENT_INITIATED",
"paymentRail": "ACH",
"paymentTime": "2022-12-29 13:42:54",
"referenceId": 63,
"remarks": "",
"remitterAccount": "1223456789",
"remitterAddress": "Dummy Address",
"remitterBic": "TRWIBEB1XXX",
"remitterCountry": "GB",
"remitterName": "Dummy Sender",
"remitterRoutingCode": "TLG0123",
"signature": "QfbNhM7BeySY7xoTygQZC86Ihm4Ojx4pJVYTF14Sy9Y=",
"status": "READY_FOR_SETTLEMENT",
"updatedStatusTime": "2022-12-29 13:50:35",
"utr": "5347f52a-9851-4fe9-8618-32eb085590ce",
"vAccountId": "97836",
"vAccountNumber": "GB38TCCL12345687997836",
"settlement": {
"expectedSettlementDate": "2023-08-30",
"firaFileDownloadUrl": "fileDownloadUrl",
"id": "b84a7c4c-2ce0-48ca-9b86-2a2c9ad5a35d",
"inrAmount": 16219.65,
"status": "INITIATED"
}
}
📘
The firaFileDownloadUrl field will only be included in the webhook response after it has been updated.
Event Name Settlement Status Description INR_SETTLEMENT_INITIATED INITIATED The settlement is initiated. INR_SETTLEMENT_APPROVED SETTLED The settlement is settled. INR_SETTLEMENT_REJECTED REJECTED The settlement is rejected. FIRA_FILE_RECEIVED SETTLED FIRA file received for the settlement.
Field Description Example amount The foreign currency amount sent 4.50 currency Three character ISO code. View list of supported currencies here . GBP cmsProfileId Merchant identifier 123 event Webhook event INTERNATIONAL_AMOUNT_COLLECTED paymentTime The time at which the payment was initiated. 2022-12-29 13:42:54 referenceId Cashfree Payments transaction identifier 63 remarks Remarks passed by the sender. Sample Remark remitterAccount The bank account number of the person who sends the money. 1223456789 remitterAddress The address of the person who sends the money. Dummy Address remitterBic Bank identifier code for the remitter. TRWIBEB1XXX remitterCountry The country from which the money is sent. GB remitterName The name of the remitter who is sending the money. John Doe remitterRoutingCode The routing code of the remitter's bank. TLG0123 signature Webhook signature QfbNhM7BeySY7xoTygQZC86Ihm4Ojx4pJVYTF14Sy9Y= status Status of FCY (foreign currency leg) of transaction. COMPLETED, FAILED, PENDING updatedStatusTime The time of the last status update. 2022-12-29 13:50:35 vAccountId Identifier of the virtual account. 97836 vAccountNumber Account number to which the payment was made. GB38TCCL12345687997836 paymentRail Payment Network used to make the payment ACH,EFT,FPS,SEPA,SWIFT,FEDWIRE settlement.id Unique reference ID for the settlement since the payment can have multiple settlements. b84a7c4c-2ce0-48ca-9b86-2a2c9ad5a35d settlement.firafileDownloadUrl Download link to FIRA file fileDownloadUrl settlement.expectedSettlementDate Expected date of settlement. 2023-08-30 settlement.inrAmount Settlement amount in rupees (INR). 16219.65 settlement.status Current status of the settlement. INITIATED
{
"cmsProfileId": 260559,
"event": "VIRTUAL_ACCOUNT_DETAILS",
"signature": "fi/o9cYwEqZLbSBAXRIwPfgiC+aOLyON7tXLv8wdH2",
"vAccounts": [
{
"accountNumber": "GB11TCCL12345638242754",
"accountType": "iban",
"paymentType": "priority",
"bankName": "The Currency Cloud Limited",
"bankAddress": "12 Steward Street, The Steward Building, London, E1 6FQ, GB",
"bankCountry": "GB",
"currency": "AUD",
"routingCode": "TCCLGB3L",
"routingCodeType": "bic_swift",
"addedOn": "2023-03-28 14:43:30",
"vaccountId": "GB11T"
},
{
"accountNumber": "GB11TCCL12345638242754",
"accountType": "iban",
"paymentType": "priority",
"bankName": "The Currency Cloud Limited",
"bankAddress": "12 Steward Street, The Steward Building, London, E1 6FQ, GB",
"bankCountry": "GB",
"currency": "BHD",
"routingCode": "TCCLGB3L",
"routingCodeType": "bic_swift",
"addedOn": "2023-03-28 14:43:30",
"vaccountId": "GB11T"
}
]
}
Sometimes there is mere might be a slight delay in creating some virtual accounts during onboarding and as a result, some of them might be missing in the Get All Collection Accounts API. Hence, when these missing account details are added, this webhook is triggered with all virtual account details (including the ones that were present before). This webhook contains information for all virtual account associated with a merchant along with cmsProfileId , signature and event.
Field Description Example cmsProfileId Merchant identifier 123 event Webhook Event VIRTUAL_ACCOUNT_DETAILS signature Webhook Signature fi/o9cYwEqZLbSBAXRIwPfgiC+aOLyON7tXLv8wdH2 vAccounts.accountNumber Account Number GB11TCCL12345638242754 vAccounts.accountType Account Type iban vAccounts.paymentType Type of Payment priority vAccounts.bankName Bank Name The Currency Cloud Limited vAccounts.bankAddress Bank Address 12 Steward Street, The Steward Building, London, E1 6FQ, GB vAccounts.bankCountry Bank Country GB vAccounts.currency Currency Code BHD vAccounts.routingCode Routing Code TCCLGB3L vAccounts.routingCodeType Routing Code Type bic_swift vAccounts.addedOn The time when this virtual account was created 2023-03-28 14:43:30 vAccounts.vaccountId Virtual Account Id GB11T
