Payout for a Different Bank Account
You can send a payout to a designated bank account that is not specified as the default bank account for payouts on your shop. This is possible for:
- domestic bank accounts (for Polish and Czech banks),
- foreign bank accounts,
- postal transfer orders (only for Polish shops).
The type of bank account chosen for the payout affects the scope of the data required in the request. Depending on whether the bank account is domestic, foreign, or a postal transfer order, specific and relevant information must be provided to facilitate a successful payout transaction.
Transfers in EUR are treated as foreign transfers. If you have a EUR account in a Polish bank, you must provide all the necessary details during the transfer, just like with a foreign transfer.
Creating a payout to the specified bank account is available only for shops that meet the verification criteria. To initiate the verification process, please reach out to us through our contact page.
Authenticating the Request
To successfully payout funds to a designated bank account, you are required to authenticate the request with an OAuth token, of type client_credentials
. This token must be generated using the configuration keys specific to the Point of Sale (POS) associated with the Shop from which you intend to withdraw funds.
Creating a Payout for the Designated Bank Account
Just like with the standard payout process, you need to send the request to the /api/v2_1/payouts
endpoint. However, this time, you are required to provide additional information about the payout along with the request.
- Domestic Bank Account
- Foreign Bank Account
curl -X POST https://secure.payu.com/api/v2_1/payouts \
-H "Content-Type: application/json" \
-H "Authorization: Bearer 3e5cac39-7e38-4139-8fd6-30adc06a61bd" \
-d '{
"shopId":"n7Cd7y1U",
"payout": {
"amount":"1000",
"description":"Some payout"
},
"account": {
"accountNumber":"59114072854040477132976504"
},
"customerAddress": {
"name":"Stefan Jaracz"
}
}'
New account number has been added in the accountNumber
field.
When withdrawing by Postal Order (postalOrder: true
), the bank account number is ignored. You still need to fill in the rest of the customerAddress
fields.
curl -X POST https://secure.payu.com/api/v2_1/payouts \
-H "Content-Type: application/json" \
-H "Authorization: Bearer 3e5cac39-7e38-4139-8fd6-30adc06a61bd" \
-d '{
"shopId":"n7Cd7y1U",
"payout": {
"amount":"1000",
"description":"Some foreign payout",
"foreign":"true"
},
"account": {
"accountNumber":"DE610639036594575851447918096101",
"swiftCode":"AARBDE5W700",
"bankName":"Aareal Bank"
},
"customerAddress": {
"street":"RICHARD STRAUSS STRASSE 24",
"city":"MUENCHEN",
"countryCode":"DE",
"name":"Steffen von Klaus"
},
"bankAddress": {
"street": "STRASSE 11",
"postalCode": "8331",
"city": "MUENCHEN",
"countryCode": "DE"
}
}'
New foreign
field set to true.
New account
object with the accountNumber
and swiftCode
parameters has been added.
customerAddress
object has been added, which is required for the requests where the foreign
is set to true.
bankAddress
object has been added, which is required for the requests where the foreign
is set to true.
The validation of input data for a payout to a specified bank account differs significantly from that of a standard payout. For details on the parameters and their specific requirements, please refer to the Create a Payout section in our API Reference.