BaaS Webhooks

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"
    }
}

Key	Type	Description
`event_type`	string	Indicate which type of event the currently sent webhook corresponds to, in this case `KYC.COMPLETED`
`issued_datetime`	string	Indicate the datetime the webhook was sent.
`payload`	string	Payload with the information about the completed verification submission.
`submission_id`	string	KYC Submission unique identifier.
`provider_url`	string or null	URL 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.
`status`	string	KYC Submission status.
`created_at`	string	ISO 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"
    }
}

Key	Type	Description
`event_type`	string	Indicate which type of event the currently sent webhook corresponds to, in this case `FIAT_ACCOUNT.ENABLED`
`issued_datetime`	string	Indicate the datetime the webhook was sent.
`payload`	string	Payload with the information about the enabled fiat account.
`fiat_account_id`	string	UUID4 formated unique id.
`payment_method_type`	string	It indicates the account type. Usually `bank_transfer`.
`currency`	string	It defines the currency that the FiatAccount accepts.
`status`	string	Indicates the Fiat Account status. Only when “ENABLED”, the fiat payment instructions will be provided.
`fiat_payment_instructions`	string	JSON fields with account identification details. It varies based on the account type.
`cvu`	string	Accunt identifier number for AR Fiat Accounts.
`created_at`	string	ISO datetime indicating Fiat Account creation date.
`end_user_id`	string	End user’s external ref

Beneficiary Fiat Account Creation Webhook

When a beneficiary fiat account is enabled, a notification will be sent with the following structure:

{
  "event_type": "BENEFICIARY_FIAT_ACCOUNT.ENABLED",
  "issue_datetime": "2025-06-04T12:42:26.061Z",
  "payload": {
    "status": "ENABLED",
    "currency": "ARS",
    "created_at": "2025-06-04T12:42:25.816728Z",
    "end_user_id": "customer_10",
    "payment_method_type": "bank_transfer",
    "fiat_payment_instructions": {
      "cvu": "0000465160000000100092"
    },
    "beneficiary_fiat_account_id": "e7e6178a-eda7-4217-bcde-a06a1b1670fa"
  }
}

Key	Type	Description
`event_type`	string	Indicate which type of event the currently sent webhook corresponds to, in this case `BENEFICIARY_FIAT_ACCOUNT.ENABLED`
`issue_datetime`	string	Indicate the datetime the webhook was sent.
`payload`	string	Payload with the information about the enabled beneficiary fiat account.
`beneficiary_fiat_account_id`	string	UUID4 formated unique id.
`payment_method_type`	string	It indicates the account type. Usually `bank_transfer`.
`currency`	string	It defines the currency that the Beneficiary Fiat Account accepts.
`status`	string	Indicates the Beneficiary Fiat Account status. Only when “ENABLED”, the fiat payment instructions will be provided.
`fiat_payment_instructions`	string	JSON fields with account identification details. It varies based on the account type.
`cvu`	string	Account identifier number for AR Beneficiary Fiat Accounts.
`created_at`	string	ISO datetime indicating Beneficiary Fiat Account creation date.
`end_user_id`	string	End 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"
    }
}

Key	Type	Description
`event_type`	string	Indicate which type of event the currently sent webhook corresponds to, in this case `FIAT_DEPOSIT.COMPLETED`
`issued_datetime`	string	Indicate the datetime the webhook was sent.
`payload`	string	Payload with the information about the completed Fiat Deposit.
`id`	string	Unique ID for this Fiat Deposit.
`created_at`	string	Indicates the creation date of the Fiat Deposit.
`updated_at`	string	Indicates the update date of the Fiat Deposit.
`currency_code`	string	Indicates the currency that has been deposited.
`end_user_id`	string	End user’s external ref, usually a uuid. Indicates the end user that has received the Fiat Deposit.
`amount`	string	Indicates the amount deposited.
`status`	string	Indicates Fiat Deposit status.
`refunded`	boolean	Indicates if the fiat deposit was refunded.
`refund_fiat_withdrawal_id`	string or null	Indicates the Fiat Withdrawal id associated with the refund, could be null.
`origin_account_identifier`	string	Indicates the identifier of the fiat deposit’s issuing account.
`origin_account_holder_id`	string	Indicates the identification of the fiat deposit’s issuing account holder.
`origin_account_holder_name`	string	Indicates 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
    }
}

Key	Type	Description
`event_type`	string	Indicate which type of event the currently sent webhook corresponds to, in this case `FIAT_WITHDRAWAL.COMPLETED`
`issued_datetime`	string	Indicate the datetime the webhook was sent.
`payload`	string	Payload with the information about the completed Fiat Withdrawal.
`id`	string	UUID used as Fiat Withdrawal identifier.
`created_at`	string	Indicates the creation date of the Fiat Withdrawal.
`updated_at`	string	Indicates the update date of the Fiat Withdrawal.
`currency_code`	string	Indicates the asset name involved in the Fiat Withdrawal.
`end_user_id`	string	End user’s external ref, usually a uuid. Identifies the user that owns this operation.
`amount`	string	Indicates the fiat amount withdrawed.
`status`	string	Specifies the Fiat Withdrawal status.
`external_ref`	string	Client side identification reference. Usually a UUID.
`beneficiary_fiat_account_id`	string or null	Indicates the Fiat Withdrawal id associated with the refund, could be null.
`is_fiat_deposit_refund`	boolean	Indicates the identifier of the fiat deposit’s issuing account.
`refunded_fiat_deposit`	string	Indicates 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.

Overview

Widget

API Reference

Completed Verification Submission Webhook

Fiat Account Creation Webhook

Beneficiary Fiat Account Creation Webhook

IPN Fiat Deposit Webhook

IPN Fiat Withdrawal Webhook

​Completed Verification Submission Webhook

​Fiat Account Creation Webhook

​Beneficiary Fiat Account Creation Webhook

​IPN Fiat Deposit Webhook

​IPN Fiat Withdrawal Webhook

Completed Verification Submission Webhook

Fiat Account Creation Webhook

Beneficiary Fiat Account Creation Webhook

IPN Fiat Deposit Webhook

IPN Fiat Withdrawal Webhook