Payout to a Russian bank card
You can send payments to Russian bank cards (Visa, MasterCard, Mir) in several ways:
- Using the widget, where your recipient enters their card details, and you get tokenized card details and pass those in your payout request.
- With open parameters, if you have a PCI DSS certificate.
- With a tokenized card number obtained using the
tokenize/elementsmethod (apply to a Bank 131 manager to learn if it available). - With an acquiring token.
Payout parameters
For payouts to Russian cards, it is mandatory to provide the recipient's full name, exactly as it is stated in their passport: not a made-up name, and not a random sequence of symbols. You can write it in Cyrillic or in the Latin alphabet, whichever you prefer. Just giving the name printed on the recipient's card (cardholder name) is insufficient.
- With tokenized data
- With unencrypted data
Mandatory parameters to perform a payout to a Russian bank card with tokenized details obtained via the widget. Consider this option if you do not have a PCI DSS certificate.
| Name | Mandatory | Type | Description |
|---|---|---|---|
| payment_method | + | object | Payment data |
| type | + | string | Value: card |
| card | + | object | Bank card payment details |
| type | + | string | Value: encrypted_card |
| encrypted_card | + | object | Card with encrypted fields |
| number_hash | + | string | Card number hash |
| amount_details | + | object | Amount |
| amount | + | int | The amount in ruble decimal format. The value must be greater than zero. To send 100 rubles, specify 10000 |
| currency | + | string | The ISO 4217 currency code. Case insensitive. Always: rub |
| participant_details | + | object | Information on payout participants |
| recipient | + | object | Recipient's details |
| full_name | + | string | Recipient's name (as it appears on the passport) |
| beneficiary_id | + | string | The INN of the beneficiary. Mandatory only for payouts from an escrow account |
| payment_details | + | object | Information about a transaction (type, description). Mandatory only for payouts from an escrow account |
| type | + | string | Value: internal_transfer |
| internal_transfer | + | object | Information about an internal transfer |
| type | + | string | Value: transfer_from_nominal_account |
| transfer_from_nominal_account | + | object | Information about a transfer from an escrow account |
| description | + | string | Description |
Mandatory parameters to perform a payout to a Russian bank card with open parameters collected on your side. Can be used if you have a PCI DSS certificate.
| Name | Mandatory | Type | Description |
|---|---|---|---|
| payment_method | + | object | Payment details (card, bank account etc.) |
| type | + | string | Value: card |
| card | + | object | Bank card payment details |
| type | + | string | Value: bank_card |
| bank_card | + | object | Unencrypted card |
| number | + | string | Card number |
| amount_details | + | object | Amount |
| amount | + | int | The amount in ruble decimal format. The value must be greater than zero. To send 100 rubles, specify 10000 |
| currency | + | string | The ISO 4217 currency code. Case insensitive. Always: rub |
| participant_details | + | object | Information on payout participants |
| recipient | + | object | Recipient's details |
| full_name | + | string | Recipient's name (as it appears on the passport) |
| beneficiary_id | + | string | The INN of the beneficiary. Mandatory only for payouts from an escrow account. |
| payment_details | + | object | Information about a transaction (type, description) Mandatory only for payouts from an escrow account |
| type | + | string | Value: internal_transfer |
| internal_transfer | + | object | Information about an internal transfer |
| type | + | string | Value: transfer_from_nominal_account |
| transfer_from_nominal_account | + | object | Information about a transfer from an escrow account |
| description | + | string | Description |
How to perform the payout
To make a payout, select one of the following scenarios:
- via the widget with tokenized parameters (without PCI DSS)
- with open parameters (if you have PCI DSS)
- a payout from an escrow account
- a payout to a bank card with a token