No momento, esta página não está disponível em português
Marketplace icon

Using an Adyen business account

Receive and send funds using an Adyen business account.

When your user has an Adyen business account, they can:

  • Receive business-related payments from third parties. Their Adyen business account is credited.
  • Make business-related payments by accepting incoming direct debit requests from third parties, for example, to pay for subscriptions. Their Adyen business account is debited.
  • Make business-related payments by transferring funds to third-party bank accounts, for example, to pay out their suppliers. Their Adyen business account is debited.

We are working on making it possible to collect payments from third-party bank accounts through direct debit. In this case, the Adyen business account is credited.

Receiving funds

An external party (sender) can send funds to your user's Adyen business account. They must use the business account number which was returned in the API response when you created the business account.

Your users must have the receiveFromThirdParty capability allowed and enabled before they can receive funds on their Adyen business account from external parties.

When a business account receives funds from an external party, Adyen informs your server through incoming bank transfer webhooks.

Receiving direct debit requests

An external party can collect payments from your user's Adyen business account through direct debit. We currently support external direct debits in the Single Euro Payments Area (SEPA). SEPA is the standardized infrastructure for bank-to-bank transactions within the European Union.

If your user wants to accept incoming SEPA direct debit requests on their Adyen business account, you need to:

  • Inform your user of their rights:

    • They have eight weeks to dispute a SEPA direct debit transaction, without providing a reason.
    • They have thirteen months to dispute an unauthorised or incorrect SEPA direct debit transaction when they provide evidence.
  • Ask your Adyen contact to enable receiving SEPA direct debits for your user.

Sending funds

Your user can send funds from their Adyen business account to third-party bank accounts. Their business account number will be shown in the bank statement of the recipient.

Your users must have the sendToThirdParty capability allowed and enabled before they can send funds from their Adyen business account to third-party accounts.

Third-party accounts are accounts not owned by your user and therefore not connected to their legal entity as a transfer instrument. Currently, Adyen only supports sending funds to third-party bank accounts. In the future, you will be able to send to third-party wallets and cards.

Before your user can send funds to third parties, reach out to your Adyen contact to:

  • Add an additional role for your API credential.
  • Enable transfers for the source balance account.

Get transfer routes

Prior to submitting a transfer request, we recommend that you calculate the available transfer routes. This will enable you to design a configuration that optimally aligns with your use case. Furthermore, it minimizes the risk of transfer failures by proactively identifying supported routes and highlighting any necessary parameters.

Send funds to third parties

When sending funds to third-party bank accounts, the required bank account details depend on the bank identification type. There are also additional required fields if you are doing a cross-border transfer. Additionally, you can validate the third-party bank account before sending funds to avoid failed transfers due to incorrect details.

To start a transfer, make a POST /transfers request specifying:

Parameter name Required Description
amount -white_check_mark- The amount and the currency of the transfer.
balanceAccountId -white_check_mark- The ID of the balance account from which funds are deducted.
category -white_check_mark- Set to bank.
bankAccount -white_check_mark- Contains details about the bank account and its owner.
  • The accountHolder.fullName is always required. For cross-border transfers, the accountHolder.address object is also required.
  • The accountIdentification is required. The fields that you need to send in this object are determined by the accountIdentification.type. See bank account identification types.
priority -white_check_mark- The priority of the bank transfer, which affects the speed of the transfer and the fees you have to pay.
description Your description for the transfer. See here for allowed characters.
reference Your reference for the transfer. This is only used within your balance platform and not sent to the recipient. If you do not provide this in the request, Adyen generates a unique reference.
referenceForBeneficiary Your reference for the transfer that Adyen sends to the recipient.

Select a tab below for examples.

If the transfer request is successful, you receive an HTTP 200 OK response containing an id of the transfer request. Adyen informs your server of the status of the transfer through outgoing bank transfer webhooks.

To better control money movement in your marketplace, you can trigger additional reviews for transfers. Additional reviews require a member of your team to verify a transfer before Adyen processes it.

You can trigger an additional review by including the review object in the POST /transfers request. In the object, specify the following parameter:

Parameter name Required Description
review.numberOfApprovalsRequired -white_check_mark- Specifies the number of approvals required to process the transfer.

Possible values: 1. Currently, it is possible to request only one additional review per transfer.
review.scaOnApproval Possible values:
true: Specifies that you will include SCA data in the POST /transfers/approve request.
false: Specifies that you are including SCA data in the POST /transfers request.

Default value: false.

The following code sample shows how to include include the review object.

If the transfer request is successful, you receive a response containing the following parameters:

Parameter name Description
review.numberOfApprovalsCompleted Shows the number of approvals completed for the transfer.
review.numberOfApprovalsRequired Shows the number of approvals required to process the transfer.
review.scaOnApproval Shows the status of the SCA process.

Possible values: required, completed, notApplicable.

After triggering the review, a member of your team must approve the transfer before Adyen continues processing it.

Transfer priority

To specify how fast the funds must be sent, you can set a priority in the transfer request. A transfer with a higher priority incurs higher fees. The priorities available for bank transfers are:

  • Regular: recommended for normal, low-value transactions to a recipient in the same location.
  • Instant: instant way to transfer funds in Single Euro Payments Area (SEPA) locations. Has higher fees than a regular payout.
  • Fast: faster than regular but has higher fees. Recommended for high-priority, low-value transactions to a recipient in the same location.
  • Wire: fastest way but has the highest fees. Recommended for high-priority, high-value transactions to a recipient in the same location.
  • Cross-border: recommended for high-value transactions to a recipient in a different location.

    When using cross-border priority, transfer delays and potential fees may occur due to involving correspondent banks. As a result, the beneficiary may receive a reduced amount compared to the one instructed.

  • Internal: transfer to an Adyen-issued business account.

Transfer cut-off times

There are specific times during a business day, called cut-off times, when Adyen stops processing bank transfers for settlement within the settlement delay. Bank transfers initiated before the cut-off time are typically processed within the specified settlement delay, while those initiated after the cut-off time will be processed the next day within the specified settlement delay.

Adhering to cut-off times can help you maintain consistency and predictability of your financial activities.

Suppose you need to make a bank transfer to a recipient in the SEPA area. Depending on when you initiate the transfer, the funds will be available the same business day or the next business day.

  1. You initiate the transfer with a wire priority at 16:20 CET (10 minutes before the 16:30 CET cut-off time). Adyen processes this transfer, and the recipient will receive the funds the same business day.
  2. You initiate the transfer with a wire priority at 17:00 CET (30 minutes after the 16:30 CET cut-off time). Because it is past the cut-off time, Adyen will process this transfer on the following business day. The funds will be available in the recipient's account on the next business day (one business day from the date of the transfer initiation).

Suppose you need to make a bank transfer to a US recipient. Depending on when you initiate the transfer, the funds will be available the next business day or the day after the next business day.

  1. You initiate the transfer with a regular priority at 01:30 ET (15 minutes before the 01:45 ET cut-off time). Adyen processes this transfer, and the recipient will receive the funds on the same business day.
  2. You initiate the transfer with a regular priority at 02:30 ET (45 minutes after the 01:45 ET cut-off time). Because it is past the cut-off time, Adyen will process this transfer at the end of the business day. The funds will be available in the recipient's account on the next business day. For example, a transfer initiated at 02:30 ET on a Tuesday will have the funds available in the beneficiary's bank account at approximately 12:00 PM ET on Wednesday.
Country/region Currency Priority Cut-off time Local timezone Settlement delay Min amount Max amount
Australia AUD Wire 15:00 AEDT Same day 0.01 999,999,999.99
Australia AUD Regular 17:15 AEDT Same day 0.01 999,999,999.99
Australia AUD Fast 23:15 AEDT Same day 0.01 5,000,000.00
Bulgaria BGN Wire 10:45 CET Same day 1.00 999,999,999.99
Bulgaria BGN Regular 10:45 CET Same day 1.00 99,999.99
Canada CAD Regular 17:45 ET Same day 1.00 999,999.99
Canada USD Regular 02:00 ET Same day 1.00 999,999.99
Czechia CZK Wire 12:00 CET Same day 0.01 999,999,999.99
Czechia CZK Regular 12:00 CET Same day 0.01 999,999,999.99
Denmark DKK Wire 14:45 CET Same day 1.00 999,999,999.99
Denmark DKK Regular 10:15 CET Same day 1.00 39,999,999.99
Hong Kong HKD Wire 14:45 HKT Same day 1.00 999,999,999.99
Hong Kong USD Wire 14:45 HKT Same day 1.00 999,999,999.99
Hong Kong HKD Regular 15:45 HKT Same day 1.00 999,999,999.99
Hungary HUF Regular 13:00 CET Same day 1.00 999,999,999.99
Norway NOK Wire 14:00 CET Same day 1.00 999,999,999.99
Norway NOK Regular 14:00 CET Same day 1.00 10,000,000.00
Poland PLN Wire 10:50 CET Same day 0.01 999,999,999.99
Poland PLN Regular 10:30 CET Same day 0.01 999,999,999.99
Romania RON Wire 10:15 CET Same day 0.50 999,999,999.99
Romania RON Regular 10:15 CET Same day 0.50 50,000.00
SEPA EUR Wire 16:55 CET Same day 0.01 999,999,999.99
SEPA EUR Regular 15:45 CET Same day 0.01 999,999,999.99
SEPA EUR Instant 24/7 CET Same day 0.01 100,000.00
Singapore SGD Wire 16:45 SGT Same day 1.00 999,999,999.99
Singapore SGD Regular 18:15 SGT Next day 1.00 90,000,000.00
Singapore SGD Fast 23:45 SGT Same day 1.00 200,000.00
Sweden SEK Wire 15:30 CET Same day 1.00 999,999,999.99
Sweden SEK Regular 12:00 CET Same day 1.00 999,999,999.99
Switzerland CHF Wire 15:45 CET Same day 0.01 999,999,999.99
Switzerland CHF Regular 11:45 CET Same day 0.01 100,000,000.00
United Kingdom GBP Wire 15:15 GMT Same day 0.01 999,999,999.99
United Kingdom GBP Regular 19:30 GMT T+2 0.01 20,000,000.00
United Kingdom GBP Fast 21:00 GMT Same day 0.01 1,000,000.00
United States USD Wire 18:30 ET Same day 0.01 9,999,999,999.99
United States USD Regular 01:45 ET Same day 0.01 99,999,999.99
United States USD Fast 16:15 ET Same day 0.01 1,000,000.00

Bank account identification types and supported priorities

When transferring funds to a third-party bank account, you need to provide the accountIdentification.type in your API request. The type also determines the required bank account details.

  1. To determine the accountIdentification.type value, you must have:
    • The location of the recipient bank account.
    • The currency of the funds you are transferring.
  2. Find the combination in the table below and select the type to see the required fields.

This combination also identifies if you are doing a local or cross-border transfer. Cross-border transfers must be sent as wire transfers, and you must include the address of the bank account owner.

The following table show the limits for the length and the characters you can use in the descriptions based on the country/region, currency and priority.

Country/region of counterparty
Currency
Supported priority
Transfer description limits
Bank account formats
Single Euro Payments Area (SEPA) countries EUR regular, instant, wire Maximum 140 characters.
Allowed characters: [a-z][A-Z][0-9]/ - ? : ( ) . , ' + Space
Default iban
Bulgaria BGN regular, wire Maximum 140 characters. Allowed characters: [a-z][A-Z][0-9]/ - ? : ( ) . , ' + Space Default iban
Czech Republic CZK regular Maximum 140 characters. Allowed characters: [a-z][A-Z][0-9]/ - ? : ( ) . , ' + Space Default iban
Custom czLocal
Denmark DKK regular, wire Maximum 140 characters. Allowed characters: [a-z][A-Z][0-9]/ - ? : ( ) . , ' + Space Default dkLocal
Custom iban
Hungary HUF regular Maximum 140 characters. Allowed characters: [a-z][A-Z][0-9]/ - ? : ( ) . , ' + Space Default iban
Custom huLocal
Norway NOK regular, wire Maximum 140 characters. Allowed characters: [a-z][A-Z][0-9]/ - ? : ( ) . , ' + Space Default noLocal
Custom iban
Poland PLN regular, wire Maximum 140 characters. Allowed characters: [a-z][A-Z][0-9]/ - ? : ( ) . , ' + Space Default plLocal
Custom iban
Romania RON regular, wire Maximum 140 characters. Allowed characters: [a-z][A-Z][0-9]/ - ? : ( ) . , ' + Space Default iban
Sweden SEK regular, wire Maximum 140 characters. Allowed characters: [a-z][A-Z][0-9]/ - ? : ( ) . , ' + Space Default seLocal
Custom iban
Switzerland CHF regular, wire Maximum 140 characters. Allowed characters: [a-z][A-Z][0-9]/ - ? : ( ) . , ' + Space Default iban
United Kingdom GBP regular, fast, wire Maximum 140 characters. Allowed characters: [a-z][A-Z][0-9]/ - ? : ( ) . , ' + Space Default ukLocal
Custom iban
Country/region of counterparty
Currency
Supported priority
Transfer description limits
Bank account formats
Canada CAD, USD regular Maximum 140 characters. Allowed characters: [a-z][A-Z][0-9]/ - ? : ( ) . , ' + Space Default caLocal
Custom usLocal
United States USD regular, fast, wire Allowed characters:
Priority: regular and fast
[a-z][A-Z][0-9]& $ % # @ ~ = + - _ ' " ! ?
Priority:wire [a-z][A-Z][0-9]/ - ? : ( ) . , ' + Space
Default usLocal
Country/region of counterparty
Currency
Supported priority
Transfer description limits
Bank account formats
Australia AUD regular, fast, wire Maximum 140 characters. Allowed characters: [a-z][A-Z][0-9]/ - ? : ( ) . , ' + Space Default auLocal
Hong Kong HKD, USD regular, wire Maximum 140 characters. Allowed characters: [a-z][A-Z][0-9]/ - ? : ( ) . , ' + Space Default hkLocal
New Zealand NZD regular, wire Maximum 140 characters. Allowed characters: [a-z][A-Z][0-9]/ - ? : ( ) . , ' + Space Default nzLocal
Singapore SGD regular, fast, wire Maximum 140 characters. Allowed characters: [a-z][A-Z][0-9]/ - ? : ( ) . , ' + Space Default sgLocal
Country/region of counterparty Currency Supported priority Transfer description limits Type and other requirements
Countries/regions where IBAN is required Any crossBorder Maximum 140 characters. Allowed characters: [a-z][A-Z][0-9] . , – ( ) / = ' + : ? ! ” % & * < > ; Space - Type: iban
- address of the bank account owner
Countries/regions where IBAN is optional
(for example, Poland or Czech Republic)
Any crossBorder Maximum 140 characters. Allowed characters: [a-z][A-Z][0-9] . , – ( ) / = ' + : ? ! ” % & * < > ; Space - Type: iban or numberAndBic
- address of the bank account owner
Other countries/regions not listed above Any crossBorder Maximum 140 characters. Allowed characters: [a-z][A-Z][0-9] . , – ( ) / = ' + : ? ! ” % & * < > ; Space - Type: numberAndBic
- address of the bank account owner

Bank account validation

Before sending funds to a third-party bank account, you can validate this bank account to avoid failed transfers due to incorrect details.

To validate a third-party bank account, make a POST /validateBankAccountIdentification request specifying the following information, depending on the bank account identification type:

Parameter Description
accountIdentification Object containing the details of the bank account to be validated.

If the bank account details are valid, you'll get an HTTP 200 OK response. You can proceed with transferring funds to this account.

In case the bank account validation fails, you'll get the details in the response. Use this information to build your own logic for handling invalid bank account details.

See also

Próximas etapas

Keep track of Adyen business account transactions using webhooks or by making an API request.