The B2B API offers a webhook mechanism to notify about events that occur asynchronously. For Banking as a Service (BaaS), there are two types of notifications sent via webhooks: event notifications and IPN (Instant Payment Notification) webhooks. Event notifications inform about specific actions such as verification completions or account creations, while IPN webhooks notify about transaction events like deposits and withdrawals.

Completed Verification Submission Webhook

For the KYC flow, a notification will be sent once the verification process has been completed. The payload will be as follows:

{
    "event_type": "KYC.COMPLETED",
    "issued_datetime": "2025-02-14T15:11:47.910383Z",
    "payload":  {
        "submission_id": "ae16bd7d-f065-434e-876c-192c373d38d1",
        "provider_url": null,
        "status": "COMPLETED",
        "created_at": "2025-02-14T14:59:41.156735Z"
    }
}
KeyTypeDescription
event_typestringIndicate which type of event the currently sent webhook corresponds to, in this case KYC.COMPLETED
issued_datetimestringIndicate the datetime the webhook was sent.
payloadstringPayload with the information about the completed verification submission.
submission_idstringKYC Submission unique identifier.
provider_urlstring or nullURL to redirect users in order for them upload or fulfill extra information. E.g: ID photo, proof of life, etc. May be null if no further information is required.
statusstringKYC Submission status.
created_atstringISO datetime indicating Verification Submission creation date.

Fiat Account Creation Webhook

In the Fiat Account creation flow, a notification will be sent once the Fiat Account creation has been completed. The payload will be as follows:

{
    "event_type": "FIAT_ACCOUNT.ENABLED",
    "issued_datetime": "2025-02-14T15:11:47.910383Z",
    "payload":  {
        "fiat_account_id": "0816ecf8-4ebc-4abb-a273-ab70bc992d1e",
        "created_at": "2025-02-14T15:11:47.910383Z",
        "payment_method_type": "bank_transfer",
        "currency": "ARS",
        "status": "ENABLED",
        "fiat_payment_instructions": {
            "cvu": "0000465160000000100092"
        },
        "end_user_id": "customer_10"
    }
}
KeyTypeDescription
event_typestringIndicate which type of event the currently sent webhook corresponds to, in this case FIAT_ACCOUNT.ENABLED
issued_datetimestringIndicate the datetime the webhook was sent.
payloadstringPayload with the information about the enabled fiat account.
fiat_account_idstringUUID4 formated unique id.
payment_method_typestringIt indicates the account type. Usually bank_transfer.
currencystringIt defines the currency that the FiatAccount accepts.
statusstringIndicates the Fiat Account status. Only when “ENABLED”, the fiat payment instructions will be provided.
fiat_payment_instructionsstringJSON fields with account identification details. It varies based on the account type.
cvustringAccunt identifier number for AR Fiat Accounts.
created_atstringISO datetime indicating Fiat Account creation date.
end_user_idstringEnd user’s external ref

IPN Fiat Deposit Webhook

When a Fiat Deposit is credited to a specific Fiat Account, an IPN will be sent with the following structure:

{
    "event_type": "FIAT_DEPOSIT.COMPLETED",
    "issued_datetime": "2025-02-14T15:11:47.910383Z",
    "payload":   {
        "id": "8142b065-79c4-4f48-9e33-11b17bc658d4",
        "created_at": "2024-04-23T14:48:33.895551Z",
        "updated_at": "2024-04-23T14:49:25.342111Z",
        "currency_code": "ARS",
        "end_user_id": "customer_10",
        "amount": "12345.67",
        "status": "COMPLETED",
        "refunded": false,
        "refund_fiat_withdrawal_id": null,
        "origin_account_identifier": "0000465160000000100092",
        "origin_account_holder_id": "20388003629",
        "origin_account_holder_name": "Carlos Pineda"
    }
}
KeyTypeDescription
event_typestringIndicate which type of event the currently sent webhook corresponds to, in this case FIAT_DEPOSIT.COMPLETED
issued_datetimestringIndicate the datetime the webhook was sent.
payloadstringPayload with the information about the completed Fiat Deposit.
idstringUnique ID for this Fiat Deposit.
created_atstringIndicates the creation date of the Fiat Deposit.
updated_atstringIndicates the update date of the Fiat Deposit.
currency_codestringIndicates the currency that has been deposited.
end_user_idstringEnd user’s external ref, usually a uuid. Indicates the end user that has received the Fiat Deposit.
amountstringIndicates the amount deposited.
statusstringIndicates Fiat Deposit status.
refundedbooleanIndicates if the fiat deposit was refunded.
refund_fiat_withdrawal_idstring or nullIndicates the Fiat Withdrawal id associated with the refund, could be null.
origin_account_identifierstringIndicates the identifier of the fiat deposit’s issuing account.
origin_account_holder_idstringIndicates the identification of the fiat deposit’s issuing account holder.
origin_account_holder_namestringIndicates the name of the fiat deposit’s issuing account holder.

If a Fiat Deposit is blocked due to limits, an IPN will be sent with the event_type value equal to: FIAT_DEPOSIT.BLOCKED_LIMIT_EXCEEDED.

If a Fiat Deposit is refunded, an IPN will be sent with the following information:

{
    "event_type": "FIAT_DEPOSIT.CANCELLED",
    "issued_datetime": "2025-02-14T15:11:47.910383Z",
    "payload":   {
        "id": "8142b065-79c4-4f48-9e33-11b17bc658d4",
        "created_at": "2024-04-23T14:48:33.895551Z",
        "updated_at": "2024-04-23T14:49:25.342111Z",
        "currency_code": "ARS",
        "end_user_id": "customer_10",
        "amount": "12345.67",
        "status": "CANCELLED",
        "refunded": true,
        "refund_fiat_withdrawal_id": "6f907606-14f8-421c-80e2-e9c2c777aeec",
        "origin_account_identifier": "0000465160000000100092",
        "origin_account_holder_id": "20388003629",
        "origin_account_holder_name": "Carlos Pineda"
    }
}

IPN Fiat Withdrawal Webhook

When a Fiat Whitdrawal is crcompleted, an IPN will be sent with the following structure:

{
    "event_type": "FIAT_WITHDRAWAL.COMPLETED",
    "issued_datetime": "2025-02-14T15:11:47.910383Z",
    "payload":   {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "transaction_id": "0fec1e58-b197-4052-99cf-2218496c5482",
        "created_at": "2019-08-24T14:15:22Z",
        "updated_at": "2019-08-24T14:18:22Z",
        "end_user_id": "customer_10",
        "amount": "12345.67",
        "status": "COMPLETED",
        "external_ref": "ac243840-ac04-4b3a-9efb-176554d4a029",
        "beneficiary_fiat_account_id": "4123e456-e89b-12d3-a456-4bedc4266abc",
        "is_fiat_deposit_refund": false,
        "refunded_fiat_deposit": null
    }
}
KeyTypeDescription
event_typestringIndicate which type of event the currently sent webhook corresponds to, in this case FIAT_WITHDRAWAL.COMPLETED
issued_datetimestringIndicate the datetime the webhook was sent.
payloadstringPayload with the information about the completed Fiat Withdrawal.
idstringUUID used as Fiat Withdrawal identifier.
created_atstringIndicates the creation date of the Fiat Withdrawal.
updated_atstringIndicates the update date of the Fiat Withdrawal.
currency_codestringIndicates the asset name involved in the Fiat Withdrawal.
end_user_idstringEnd user’s external ref, usually a uuid. Identifies the user that owns this operation.
amountstringIndicates the fiat amount withdrawed.
statusstringSpecifies the Fiat Withdrawal status.
external_refstringClient side identification reference. Usually a UUID.
beneficiary_fiat_account_idstring or nullIndicates the Fiat Withdrawal id associated with the refund, could be null.
is_fiat_deposit_refundbooleanIndicates the identifier of the fiat deposit’s issuing account.
refunded_fiat_depositstringIndicates the identification of the fiat deposit’s issuing account holder.

If a Fiat Withdrawal is not completed due to an external issue, it will remain in a CANCELLED state, and an IPN will be sent with event_type equal to: FIAT_WITHDRAWAL.CANCELLED.

When a Fiat Withdrawal is created, it will be in a PENDING status, and an IPN will be sent with event_type equal to: FIAT_WITHDRAWAL.PENDING.