1. Transfers & Payments Webhooks
Partner API
  • Getting Started
    • Introduction
    • Authentication
    • Business Use Cases
  • API References
    • Partner Operations
      • Balances & Transaction History
        • Get Balances
        • Get Transaction History
        • Create Wallet
      • Currency Exchange
        • Retrieve Exchange Rate
        • Retrieve Exchange Rate and Create a Lock
        • Create and Finalize an Exchange
        • Retrieve Detailed Exchange Information
      • SEPA Transfers
        • Get SEPA Deposit Info
        • Get SEPA Deposit Contact List
        • Create a SEPA Transfer
        • Get SEPA Transfer Details
      • Crypto Withdrawal
        • Get Network Fee
        • Create Crypto Withdrawal
        • Get Crypto Withdrawal Details
      • Crypto Deposits
        • Update Travel Rule
      • Orders
        • Get Rates
        • Retrieve Order Rate and Create a Lock
        • Create and Finalize an Order
        • Get Order Details
      • Payment link & Checkout Link
        • Generate Payment Link
        • Generate Hosted Checkout
        • Get Payment Link Details
    • User Operations
      • Onboarding & KYC Flow
        • Create User Account
        • Method A: Add KYC File
        • Method B: Creating KYC Verification
        • Method B: Redirect to Verification
        • Method B: Get KYC Status
        • Add User Verification
        • Add POA File
      • Account Management
        • Update Existing User
        • Delete User
        • Suspend User
        • Unsuspend User
      • Balances & Transaction History
        • Get User Balances
        • Get User Transaction History
      • Currency Exchange
        • Retrieve Exchange Rate
        • Retrieve Exchange Rate and Create a Lock
        • Create and Finalize an Exchange
        • Retrieve Detailed Exchange Information
      • SEPA Transfers
        • Get SEPA Deposit Info
        • GET SEPA Deposit Contact List
        • Create a SEPA Transfer
        • Get SEPA Transfer Details
      • Crypto Withdrawal
        • Get Network Fee
        • Create Crypto Withdrawal
        • Get Crypto Withdrawal Details
      • Crypto Deposits
        • Update Travel Rule
      • Internal Transfers
        • Create a Transfer
        • Get Transfer Details
      • Virtual Cards
        • Create Virtual Card
        • Get All User Cards
        • Get Card Details
        • Update Card PIN
        • Block Card
        • Unblock Card
        • Get Card Limits
        • Update Card Limits
        • Delete Card
  • Integration
    • SDKs & Integration Guides
    • Transaction Processing
    • Error Handling
    • Rate Limiting
    • Webhooks
      • User & KYC Webhooks
        • User Balance Generation Webhook
        • KYC File Added Webhook
        • POA Verification Status Webhook
        • KYC Verification Status Webhook
        • Create Wallet Webhook
        • High Risk KYC Verification Webhook
      • Transfers & Payments Webhooks
        • Internal Transfer Webhook
        • IBAN Status Webhook
        • Partner SEPA Transfer Webhook
        • User SEPA Transfer Webhook
        • SEPA Deposit Webhook
        • Crypto Withdrawal Webhook
        • Crypto Deposit Webhook
        • Exchange Webhook
        • Card Transaction Webhook
        • Order Status Webhook
        • Payment Link Webhook
      • Card Webhooks
        • Card 3DS Code Webhook
        • Card Activation Code Webhook
  • Reference
    • Supported Countries
    • Supported Currencies
    • Fees
    • FAQ
    • Changelog
    • Support
  1. Transfers & Payments Webhooks

IBAN Status Webhook

Webhook
POST
iban-status-webhook
This event is dispatched whenever the verification lifecycle of a user's dedicated IBAN is updated. It is a critical part of the First-Party Payment verification flow: after a user makes an initial verification deposit, the system automatically validates whether the sender's name matches the user's verified identity data. This webhook notifies you of the result, marking the IBAN status as APPROVED or REJECTED.

Verification Logic#

When a verification deposit is received, the system follows this automated workflow:
PENDING: A deposit is detected from a specific IBAN. The transaction enters a pending state while the system performs name-matching and compliance checks.
APPROVED: If the sender details are accepted:
Funds are credited to the user's fiat balance.
The IBAN is automatically added to the user's verified contact list and can be used for future withdrawals.
REJECTED: If a significant mismatch or compliance issue is detected:
The deposit is rejected.
The system initiates a return of funds to the original sender's IBAN.

What This Webhook Means#

This webhook can be used as the operational signal for IBAN verification state changes.
Whitelist Activation: Once you receive APPROVED for a specific IBAN, that IBAN can be treated as verified for the user.
Deposit Outcome: The webhook tells you whether the verification deposit resulted in successful account activation or rejection.
Refund Awareness: A REJECTED status means the deposit was not accepted and the return flow has been initiated.

Recommended Integration Behavior#

Use this webhook to:
update the verification state of user bank accounts in your own system,
unlock withdrawal options once an IBAN becomes approved,
notify users when their verification deposit succeeds or fails,
avoid polling the contact list unnecessarily during the verification flow.
Relationship to SEPA Contact List
An IBAN marked as APPROVED through this webhook should later appear in the user's verified SEPA contact list and can then be used as a withdrawal destination.

Request

Body Params application/jsonRequired

Examples

Responses

🟢200Success
application/json
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://your-api-server.com' \
--header 'Content-Type: application/json' \
--data '{
    "externalUserId": "exampleuserid123",
    "status": "APPROVED",
    "iban": "DK1084758300566382"
}'
Response Response Example
{}
Previous
Internal Transfer Webhook
Next
Partner SEPA Transfer Webhook
Built with