| What to Collect from Users | Description | Request Field | Example | 
|---|
| Recipient's Full Name | The full name of the bank account holder (must exactly match bank account registration) | account_holder_name | Simon | 
| Account Number | The recipient's bank account number (typically 8-12 digits, without spaces or special characters) | account_number | 58370400440532018602 | 
| IBAN Type | International standard code identifying the bank account routing method (e.g., iban, aba, sort) | routing_type | iban | 
| Bank Identifier Code | Unique code for international/domestic bank identification (e.g., IBAN, SWIFT/BIC, ABA) Note: Formats vary by country (e.g., IBAN includes country code, ABA is 9 digits)
 | routing_number | AT483200000012345864 (Austria IBAN example) | 
| Recipient Bank Country | Use ISO 3166-1 two-letter country codes | country | Example for Austria: AT | 
Austria#
Supported Payout Methods#
| Payout Method | Supported Currency | 
|---|
| Bank account | EUR | 
Request Example#
The following example shows the minimum parameter set. For parameter descriptions, refer to: [Create a Payout]account_name: luhudaxue
routing_type: iban
routing_number: AT91967209385576
account_number: 58370400440532018602
country: AT{
    "payment_currency": "EUR",
    "payment_amount": 5500,
    "source_currency": "EUR",
    "beneficiary_data": {
        "destination_data": {
            "destination_type": "bank_account",
            "bank_account": {
                "account_number": "58370400440532018602",
                "account_holder_name": "luhudaxue",
                "country": "AT",
                "routing_type": "iban",
                "routing_number": "AT91967209385576"
            }
        }
    },
    "merchant_payout_id": "pay_123123123"
}
Belgium#
Supported Payout Methods#
| Payout Method | Supported Currency | 
|---|
| Bank account | EUR | 
Request Example#
The following example shows the minimum parameter set. For parameter descriptions, refer to: [Create a Payout]
account_name: luhudaxue
routing_type: iban
routing_number: BE91967209385576
account_number: 58370400440532018602
country: BE{
    "payment_currency": "EUR",
    "payment_amount": 5500,
    "source_currency": "EUR",
    "beneficiary_data": {
        "destination_data": {
            "destination_type": "bank_account",
            "bank_account": {
                "account_number": "58370400440532018602",
                "account_holder_name": "luhudaxue",
                "country": "BE",
                "routing_type": "iban",
                "routing_number": "BE91967209385576"
            }
        }
    },
    "merchant_payout_id": "pay_123123123"
}
Finland#
Supported Payout Methods#
| Payout Method | Supported Currency | 
|---|
| Bank account | EUR | 
Request Example#
The following example shows the minimum parameter set. For parameter descriptions, refer to: [Create a Payout]
account_name: luhudaxue
routing_type: iban
routing_number: FI91967209385576
account_number: 58370400440532018602
country: FI{
    "payment_currency": "EUR",
    "payment_amount": 5500,
    "source_currency": "EUR",
    "beneficiary_data": {
        "destination_data": {
            "destination_type": "bank_account",
            "bank_account": {
                "account_number": "58370400440532018602",
                "account_holder_name": "luhudaxue",
                "country": "FI",
                "routing_type": "iban",
                "routing_number": "FI91967209385576"
            }
        }
    },
    "merchant_payout_id": "pay_123123123"
}
France#
Supported Payout Methods#
| Payout Method | Supported Currency | 
|---|
| Bank account | EUR | 
Request Example#
The following example shows the minimum parameter set. For parameter descriptions, refer to: [Create a Payout]
account_name: luhudaxue
routing_type: iban
routing_number: FR91967209385576
account_number: 58370400440532018602
country: FR{
    "payment_currency": "EUR",
    "payment_amount": 5500,
    "source_currency": "EUR",
    "beneficiary_data": {
        "destination_data": {
            "destination_type": "bank_account",
            "bank_account": {
                "account_number": "58370400440532018602",
                "account_holder_name": "luhudaxue",
                "country": "FR",
                "routing_type": "iban",
                "routing_number": "FR91967209385576"
            }
        }
    },
    "merchant_payout_id": "pay_123123123"
}
Germany#
Supported Payout Methods#
| Payout Method | Supported Currency | 
|---|
| Bank account | EUR | 
Request Example#
The following example shows the minimum parameter set. For parameter descriptions, refer to: [Create a Payout]
account_name: luhudaxue
routing_type: iban
routing_number: DE91967209385576
account_number: 58370400440532018602
country: DE{
    "payment_currency": "EUR",
    "payment_amount": 5500,
    "source_currency": "EUR",
    "beneficiary_data": {
        "destination_data": {
            "destination_type": "bank_account",
            "bank_account": {
                "account_number": "58370400440532018602",
                "account_holder_name": "luhudaxue",
                "country": "DE",
                "routing_type": "iban",
                "routing_number": "DE91967209385576"
            }
        }
    },
    "merchant_payout_id": "pay_123123123"
}
Ireland#
Supported Payout Methods#
| Payout Method | Supported Currency | 
|---|
| Bank account | EUR | 
Request Example#
The following example shows the minimum parameter set. For parameter descriptions, refer to: [Create a Payout]
account_name: luhudaxue
routing_type: iban
routing_number: IE91967209385576
account_number: 58370400440532018602
country: IE{
    "payment_currency": "EUR",
    "payment_amount": 5500,
    "source_currency": "EUR",
    "beneficiary_data": {
        "destination_data": {
            "destination_type": "bank_account",
            "bank_account": {
                "account_number": "58370400440532018602",
                "account_holder_name": "luhudaxue",
                "country": "IE",
                "routing_type": "iban",
                "routing_number": "IE91967209385576"
            }
        }
    },
    "merchant_payout_id": "pay_123123123"
}
Italy#
Supported Payout Methods#
| Payout Method | Supported Currency | 
|---|
| Bank account | EUR | 
Request Example#
The following example shows the minimum parameter set. For parameter descriptions, refer to: [Create a Payout]
account_name: luhudaxue
routing_type: iban
routing_number: IT91967209385576
account_number: 58370400440532018602
country: IT{
    "payment_currency": "EUR",
    "payment_amount": 5500,
    "source_currency": "EUR",
    "beneficiary_data": {
        "destination_data": {
            "destination_type": "bank_account",
            "bank_account": {
                "account_number": "58370400440532018602",
                "account_holder_name": "luhudaxue",
                "country": "IT",
                "routing_type": "iban",
                "routing_number": "IT91967209385576"
            }
        }
    },
    "merchant_payout_id": "pay_123123123"
}
Luxembourg#
Supported Payout Methods#
| Payout Method | Supported Currency | 
|---|
| Bank account | EUR | 
Request Example#
The following example shows the minimum parameter set. For parameter descriptions, refer to: [Create a Payout]
account_name: luhudaxue
routing_type: iban
routing_number: LU91967209385576
account_number: 58370400440532018602
country: LU{
    "payment_currency": "EUR",
    "payment_amount": 5500,
    "source_currency": "EUR",
    "beneficiary_data": {
        "destination_data": {
            "destination_type": "bank_account",
            "bank_account": {
                "account_number": "58370400440532018602",
                "account_holder_name": "luhudaxue",
                "country": "LU",
                "routing_type": "iban",
                "routing_number": "LU91967209385576"
            }
        }
    },
    "merchant_payout_id": "pay_123123123"
}
Netherlands#
Supported Payout Methods#
| Payout Method | Supported Currency | 
|---|
| Bank account | EUR | 
Request Example#
The following example shows the minimum parameter set. For parameter descriptions, refer to: [Create a Payout]
account_name: luhudaxue
routing_type: iban
routing_number: NL91967209385576
account_number: 58370400440532018602
country: NL{
    "payment_currency": "EUR",
    "payment_amount": 5500,
    "source_currency": "EUR",
    "beneficiary_data": {
        "destination_data": {
            "destination_type": "bank_account",
            "bank_account": {
                "account_number": "58370400440532018602",
                "account_holder_name": "luhudaxue",
                "country": "NL",
                "routing_type": "iban",
                "routing_number": "NL91967209385576"
            }
        }
    },
    "merchant_payout_id": "pay_123123123"
}
Portugal#
Supported Payout Methods#
| Payout Method | Supported Currency | 
|---|
| Bank account | EUR | 
Request Example#
The following example shows the minimum parameter set. For parameter descriptions, refer to: [Create a Payout]
account_name: luhudaxue
routing_type: iban
routing_number: PT91967209385576
account_number: 58370400440532018602
country: PT{
    "payment_currency": "EUR",
    "payment_amount": 5500,
    "source_currency": "EUR",
    "beneficiary_data": {
        "destination_data": {
            "destination_type": "bank_account",
            "bank_account": {
                "account_number": "58370400440532018602",
                "account_holder_name": "luhudaxue",
                "country": "PT",
                "routing_type": "iban",
                "routing_number": "PT91967209385576"
            }
        }
    },
    "merchant_payout_id": "pay_123123123"
}
Spain#
Supported Payout Methods#
| Payout Method | Supported Currency | 
|---|
| Bank account | EUR | 
Request Example#
The following example shows the minimum parameter set. For parameter descriptions, refer to: [Create a Payout]
account_name: luhudaxue
routing_type: iban
routing_number: ES91967209385576
account_number: 58370400440532018602
country: ES{
    "payment_currency": "EUR",
    "payment_amount": 5500,
    "source_currency": "EUR",
    "beneficiary_data": {
        "destination_data": {
            "destination_type": "bank_account",
            "bank_account": {
                "account_number": "58370400440532018602",
                "account_holder_name": "luhudaxue",
                "country": "ES",
                "routing_type": "iban",
                "routing_number": "ES91967209385576"
            }
        }
    },
    "merchant_payout_id": "pay_123123123"
}
Greece#
Supported Payout Methods#
| Payout Method | Supported Currency | 
|---|
| Bank account | EUR | 
Request Example#
The following example shows the minimum parameter set. For parameter descriptions, refer to: [Create a Payout]
account_name: luhudaxue
routing_type: iban
routing_number: GR91967209385576
account_number: 58370400440532018602
country: GR{
    "payment_currency": "EUR",
    "payment_amount": 5500,
    "source_currency": "EUR",
    "beneficiary_data": {
        "destination_data": {
            "destination_type": "bank_account",
            "bank_account": {
                "account_number": "58370400440532018602",
                "account_holder_name": "luhudaxue",
                "country": "GR",
                "routing_type": "iban",
                "routing_number": "GR91967209385576"
            }
        }
    },
    "merchant_payout_id": "pay_123123123"
}
Cyprus#
Supported Payout Methods#
| Payout Method | Supported Currency | 
|---|
| Bank account | EUR | 
Request Example#
The following example shows the minimum parameter set. For parameter descriptions, refer to: [Create a Payout]
account_name: luhudaxue
routing_type: iban
routing_number: CY91967209385576
account_number: 58370400440532018602
country: CY{
    "payment_currency": "EUR",
    "payment_amount": 5500,
    "source_currency": "EUR",
    "beneficiary_data": {
        "destination_data": {
            "destination_type": "bank_account",
            "bank_account": {
                "account_number": "58370400440532018602",
                "account_holder_name": "luhudaxue",
                "country": "CY",
                "routing_type": "iban",
                "routing_number": "CY91967209385576"
            }
        }
    },
    "merchant_payout_id": "pay_123123123"
}
Slovakia#
Supported Payout Methods#
| Payout Method | Supported Currency | 
|---|
| Bank account | EUR | 
Request Example#
The following example shows the minimum parameter set. For parameter descriptions, refer to: [Create a Payout]
account_name: luhudaxue
routing_type: iban
routing_number: SK91967209385576
account_number: 58370400440532018602
country: SK{
    "payment_currency": "EUR",
    "payment_amount": 5500,
    "source_currency": "EUR",
    "beneficiary_data": {
        "destination_data": {
            "destination_type": "bank_account",
            "bank_account": {
                "account_number": "58370400440532018602",
                "account_holder_name": "luhudaxue",
                "country": "SK",
                "routing_type": "iban",
                "routing_number": "SK91967209385576"
            }
        }
    },
    "merchant_payout_id": "pay_123123123"
}
Lithuania#
Supported Payout Methods#
| Payout Method | Supported Currency | 
|---|
| Bank account | EUR | 
Request Example#
The following example shows the minimum parameter set. For parameter descriptions, refer to: [Create a Payout]
account_name: luhudaxue
routing_type: iban
routing_number: LT91967209385576
account_number: 58370400440532018602
country: LT{
    "payment_currency": "EUR",
    "payment_amount": 5500,
    "source_currency": "EUR",
    "beneficiary_data": {
        "destination_data": {
            "destination_type": "bank_account",
            "bank_account": {
                "account_number": "58370400440532018602",
                "account_holder_name": "luhudaxue",
                "country": "LT",
                "routing_type": "iban",
                "routing_number": "LT91967209385576"
            }
        }
    },
    "merchant_payout_id": "pay_123123123"
}
Croatia#
Supported Payout Methods#
| Payout Method | Supported Currency | 
|---|
| Bank account | EUR | 
Request Example#
The following example shows the minimum parameter set. For parameter descriptions, refer to: [Create a Payout]
account_name: luhudaxue
routing_type: iban
routing_number: HR91967209385576
account_number: 58370400440532018602
country: HR{
    "payment_currency": "EUR",
    "payment_amount": 5500,
    "source_currency": "EUR",
    "beneficiary_data": {
        "destination_data": {
            "destination_type": "bank_account",
            "bank_account": {
                "account_number": "58370400440532018602",
                "account_holder_name": "luhudaxue",
                "country": "HR",
                "routing_type": "iban",
                "routing_number": "HR91967209385576"
            }
        }
    },
    "merchant_payout_id": "pay_123123123"
}
Retrieve a Payout#
Webhook#
POST:/v1/webhook_endpoints{
    "url": "https://...", 
    "description": "I am description",
    "enabled_events": [
        "payout.canceled",
        "payout.created",
        "payout.failed",
        "payout.paid",
        "payout.updated"
    ]
}
Once a webhook is successfully registered, an HTTPS request will be automatically sent to the registered URL whenever any of the specified events occur.
Test Webhook#
Create a payout to trigger thepayout.createdevent. This will send a callback notification about the payout creation event to your designated Webhook URL.Modified at 2025-08-08 05:49:15