---
title: "Add Bank Account for Payouts"
method: POST
path: "/api/aml-verification/v1/dataloading/payouts/bankAccountData"
tags: ["Marketplace-Verification"]
---

# Add Bank Account for Payouts

`POST /api/aml-verification/v1/dataloading/payouts/bankAccountData`

## Request

- Base URL: `https://secure.payu.com`
- URL: `https://secure.payu.com/api/aml-verification/v1/dataloading/payouts/bankAccountData`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/payu-com/apis/payu-gpo-europe-rest-api/docs/api/aml-verification/v1/dataloading/payouts/bankAccountData/post.ts> (a function with typed inputs; its response is checked against the schema)

Send bank account data for the payouts.

## Headers

- `Content-Type` string, required
- `Authorization` string, required

## Request body

- union
  - PayoutWithVerificationTransfer
    - `bankDataId` string, required: Id of the bank account details assigned by marketplace.
    - `verificationId` string, required: Id of verification in context of which data are provided.
    - `accountNumberRequested` string, IBAN, required: Bank account number declared for withdrawals by submerchant.
    - `hasDocument` string: Flag informing that this bank account for payouts should be verified on base of bank document. **It must be set to true when the method used is "BANK_STATEMENT"**.
    - `payoutDataVerificationType` 'LIAN_LIAN' | 'PINGPONG' | 'OFX' | 'BANK_STATEMENT' | 'BANK_TRANSFER' | 'NO_VERIFICATION_NEEDED', required: Type of verification used for the provided payout details verification. Different for each verification type: * **LIAN_LIAN** - special type for Chinese submerchants, * **PINGPONG** - special type for Chinese submerchants, * **OFX** - special type for Chinese submerchants, * **BANK_STATEMENT** - used if all data are present on the document (**`hasDocument` must be true**), * **BANK_TRANSFER**, * **NO_VERIFICATION_NEEDED** - used if the provided bank account number was not yet verified by 3rd party but it doesn't have to be verified at the time of providing the bank details. It is used for the occasional transaction process when the bank account number is provided at the beginning of the process.
    - `foreign` string, required: Foreign Transfer Indicator. Has to be `true` for all cross-border payouts and payouts in EUR. **For domestic transfers set this parameter to `false`, specifically**: - Payouts in CZK (Czech Koruna) to an account held in the Czech Republic. - Payouts in PLN (Polish Złoty) to an account held in Poland.
    - `verificationTransferId` string, required: Have to be indicated in request with declared payouts data. Payouts data need to be declared in 72 hours from above request/response.
    - `verified` string, required: parameter indicating whether the bank account number was already verified e.g. by another provider. If set to **false** and the verification type is other than "NO_VERIFICATION_NEEDED" PayU must verify the bank account details.
  - PayoutWithoutVerificationTransfer
    - `bankDataId` string, required: Id of the bank account details assigned by marketplace.
    - `verificationId` string, required: Id of verification in context of which data are provided.
    - `accountNumberRequested` string, IBAN, required: Bank account number declared for withdrawals by submerchant.
    - `hasDocument` string: Flag informing that this bank account for payouts should be verified on base of bank document. **It must be set to true when the method used is "BANK_STATEMENT**".
    - `swiftCode` string: Standard format of Bank Identifier Code.
    - `bankAddress` string: Bank address.
    - `bankCountry` string: Bank country. **Required for foreign bank account**.
    - `payoutDataVerificationType` 'LIAN_LIAN' | 'PINGPONG' | 'OFX' | 'BANK_STATEMENT' | 'BANK_TRANSFER' | 'NO_VERIFICATION_NEEDED', required: Type of verification used for the provided payout details verification. Different for each verification type: * **LIAN_LIAN** - special type for Chinese submerchants, * **PINGPONG** - special type for Chinese submerchants, * **OFX** - special type for Chinese submerchants, * **BANK_STATEMENT** - used if all data are present on the document (**`hasDocument` must be true**), * **BANK_TRANSFER**, * **NO_VERIFICATION_NEEDED** - used if the provided bank account number was not yet verified by 3rd party but it doesn't have to be verified at the time of providing the bank details. It is used for the occasional transaction process when the bank account number is provided at the beginning of the process.
    - `statementData` object: Details from bank statement.
      - `accountNumberFromBank` string
      - `ownerName` string, required: Name of the account owner from bank transfer.
      - `address` object, required
        - `street` string: Street name.
        - `zipcode` string: Zipcode
        - `city` string: City name.
        - `country` string, ISO Country Code: Country code.
    - `foreign` string, required: Foreign Transfer Indicator. Has to be `true` for all cross-border payouts and payouts in EUR. **For domestic transfers set this parameter to `false`, specifically**: - Payouts in CZK (Czech Koruna) to an account held in the Czech Republic. - Payouts in PLN (Polish Złoty) to an account held in Poland.
    - `verified` string, required: parameter indicating whether the bank account number was already verified e.g. by another provider. If set to **false** and the verification type is other than "NO_VERIFICATION_NEEDED" PayU must verify the bank account details.
  - PayoutBankStatement
    - `bankDataId` string, required: Id of the bank account details assigned by marketplace.
    - `verificationId` string, required: Id of verification in context of which data are provided.
    - `accountNumberRequested` string, IBAN, required: Bank account number declared for withdrawals by submerchant.
    - `hasDocument` string, required: Flag informing that this bank account for payouts should be verified on base of bank document. **It must be set to true when the method used is "BANK_STATEMENT**".
    - `payoutDataVerificationType` 'LIAN_LIAN' | 'PINGPONG' | 'OFX' | 'BANK_STATEMENT' | 'BANK_TRANSFER' | 'NO_VERIFICATION_NEEDED', required: Type of verification used for the provided payout details verification. Different for each verification type: * **LIAN_LIAN** - special type for Chinese submerchants, * **PINGPONG** - special type for Chinese submerchants, * **OFX** - special type for Chinese submerchants, * **BANK_STATEMENT** - used if all data are present on the document (**`hasDocument` must be true**), * **BANK_TRANSFER**, * **NO_VERIFICATION_NEEDED** - used if the provided bank account number was not yet verified by 3rd party but it doesn't have to be verified at the time of providing the bank details. It is used for the occasional transaction process when the bank account number is provided at the beginning of the process.
    - `foreign` string, required: Foreign Transfer Indicator. Has to be `true` for all cross-border payouts and payouts in EUR. **For domestic transfers set this parameter to `false`, specifically**: - Payouts in CZK (Czech Koruna) to an account held in the Czech Republic. - Payouts in PLN (Polish Złoty) to an account held in Poland.
    - `verified` string, required: parameter indicating whether the bank account number was already verified e.g. by another provider. If set to **false** and the verification type is other than "NO_VERIFICATION_NEEDED" PayU must verify the bank account details.

## Response `204`

SUCCESS

## Other responses

- `400`: Error encountered during posting the data for verification
- `403`: Error encountered during posting the data for verification
- `404`: Error encountered during posting the data for verification
- `409`: Verification state does not allow operation.

---

[API](https://skmtc.dev/payu-com/apis/payu-gpo-europe-rest-api.md) - [All operations](https://skmtc.dev/payu-com/apis/payu-gpo-europe-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/payu-com/apis/payu-gpo-europe-rest-api/revisions/185e74d5e007?raw)