The B2B API provides a webhook mechanism for notifying events that occur asynchronously. For BaaS, there are two types of notifications sent via webhooks.

​
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

Was this page helpful?

IPN Webhooks