WooshPay OpenAPI
Product DocumentAPI ReferenceJS SDK ReferenceSaaS Platform Integration
Product DocumentAPI ReferenceJS SDK ReferenceSaaS Platform Integration
Back to WooshPay Website
  1. Payout-Regional payout solution
  • Online payments
    • Quick Start
    • Integration overview
    • Wooshpay JS SDK
    • Wooshpay Checkout
    • Wooshpay Direct API
    • Payment Link
    • Authorize and capture
    • Build subscriptions integration
    • Testing cards
  • After the payment
    • Payouts
    • Webhook
    • Check the webhook signatures
    • 校验webhook签名
  • Add more payment methods
    • Supported payment method
    • Cards
    • Wallets
      • Alipay
      • Alipay HK
      • Apple Pay
      • Google Pay
      • Wechat Pay
      • 微信支付
      • Kakao Pay
      • DANA
      • Boost
      • Grabpay
      • Mcash
      • Touch'n Go
      • ShopeePay
      • UnionPay
      • 9Pay
      • OVO
      • GCash
      • TrueMoney
    • Bank redirects
      • Bancontact
      • BPI
      • Trustly
      • EPS
      • Giropay
      • iDEAL
      • Przelewy24
      • FPX
    • Buy Now Pay Later
      • Klarna
    • Bank Debits
      • Sepa Direct Debit
    • Bank Transfer
      • Bank Transfer in Europe
      • Bank Transfer in United Kingdom
      • Bank Transfer in Indonesia
    • QR Payments
      • QRIS
      • PromptPay
    • Real-time payments
      • PIX
      • PayNow
      • UPI
      • SPEI
  • More payment scenarios
    • Set up future payments
    • Save payment method during payment
  • SaaS platform integration
    • Shopify Plugin
    • Shopastro 星盘
    • WooCommerce
    • Shoplazza 店匠
    • Shopline Plugin
    • Sage Connection
  • Resources
    • Supported currencies
  • Payout-Regional payout solution
    • ZA
    • NG
    • USA
    • UK
    • EU
  1. Payout-Regional payout solution

EU

Payout Required Information (Consistent for Eurozone Countries)#

What to Collect from UsersDescriptionRequest FieldExample
Recipient's Full NameThe full name of the bank account holder (must exactly match bank account registration)account_holder_nameSimon
Account NumberThe recipient's bank account number (typically 8-12 digits, without spaces or special characters)account_number58370400440532018602
IBAN TypeInternational standard code identifying the bank account routing method (e.g., iban, aba, sort)routing_typeiban
Bank Identifier CodeUnique 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_numberAT483200000012345864 (Austria IBAN example)
Recipient Bank CountryUse ISO 3166-1 two-letter country codescountryExample for Austria: AT

Austria#

Supported Payout Methods#

Payout MethodSupported Currency
Bank accountEUR

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
text
{
    "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 MethodSupported Currency
Bank accountEUR

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
text
{
    "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 MethodSupported Currency
Bank accountEUR

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
text
{
    "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 MethodSupported Currency
Bank accountEUR

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
text
{
    "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 MethodSupported Currency
Bank accountEUR

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
text
{
    "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 MethodSupported Currency
Bank accountEUR

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
text
{
    "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 MethodSupported Currency
Bank accountEUR

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
text
{
    "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 MethodSupported Currency
Bank accountEUR

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
text
{
    "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 MethodSupported Currency
Bank accountEUR

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
text
{
    "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 MethodSupported Currency
Bank accountEUR

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
text
{
    "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 MethodSupported Currency
Bank accountEUR

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
text
{
    "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 MethodSupported Currency
Bank accountEUR

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
text
{
    "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 MethodSupported Currency
Bank accountEUR

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
text
{
    "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 MethodSupported Currency
Bank accountEUR

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
text
{
    "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 MethodSupported Currency
Bank accountEUR

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
text
{
    "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 MethodSupported Currency
Bank accountEUR

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
text
{
    "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#

Retrieve a Payout
GET:/v1/payouts/{id}

Webhook#

Create Webhook
POST:/v1/webhook_endpoints
{
    "url": "https://...", //用于接收Webhook的url
    "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-07-25 02:32:55
Previous
UK
Built with