Payout parameters for Russian bank cards
You can send payouts 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.
- With a tokenized card number obtained using the
tokenize/elementsmethod (apply to a Bank 131 manager to learn if it is 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
Below are the mandatory parameters to perform a payout to a Russian bank card with tokenized details obtained via the widget.
| Name | Mandatory | Type | Description |
|---|---|---|---|
| payment_method/payout_details | + | object | Payment data |
| type | + | string | Value: card |
| card | + | object | Bank card payment details |
| type | + | string | Value: encrypted_card |
| encrypted_card | + | object | Encrypted card details |
| number_hash | + | string | Card number hash |
| amount_details | + | object | Amount |
| amount | + | int | Amount in ruble decimal format. The value must be greater than zero. To send 100 rubles, specify 10000 |
| currency | + | string | 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 | 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 |
Below are the mandatory parameters to perform a payout to a Russian bank card with open parameters collected on your side.
| Name | Mandatory | Type | Description |
|---|---|---|---|
| payment_method/payout_details | + | 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 details |
| number | + | string | Card number |
| amount_details | + | object | Amount |
| amount | + | int | Amount in ruble decimal format. The value must be greater than zero. To send 100 rubles, specify 10000 |
| currency | + | string | 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 | 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
- with open parameters
- from an escrow account
- with a token