Payout to a foreign bank card
You can send payments to foreign bank cards in two ways:
- using the widget, where your recipient enters their card details, and you get tokenized card details and pass those in your payout request;
- or with open parameters, if you have a PCI DSS certificate.
Mandatory payout parameters
When performing payouts to a foreign bank card, you need to specify the following:
- card number;
- amount in ruble decimal format (e.g. if you are
paying 100 rubles, you will need to pass
10000
in theamount_details.amount
field); - payer details: name, company name, address, country, city;
- recipient's name.
Foreign bank card with tokenized details
Mandatory parameters to perform a payout to a foreign bank card with tokenized details obtained via the widget. Consider this option if you do not have a PCI DSS certificate.
Name | Type | Description |
---|---|---|
payment_method | PaymentMethod | Payment data |
type | string | value: card |
card | CardPaymentMethod | Bank card payment details |
type | string | value: encrypted_card |
encrypted_card | EncryptedCard | Card with encrypted fields |
number_hash | string | Card number hash |
amount_details | AmountDetails | The amount |
amount | int | The amount in ruble decimal format. The value must be greater than zero. If you are sending 100 rubles, you will need to specify 10000 |
currency | string | The ISO 4217 currency code. Case insensitive. Always: rub |
participant_details | ParticipantDetails | Information on payout participants |
sender | Participant | Sender's details |
full_name | string | Name |
company_name | string | Company name |
address_line | string | Address |
country_iso3 | string | The country (ISO-3166-1 alpha-3) |
city | string | The city |
recipient | Participant | Recipient's details |
full_name | string | Recipient's name |
Foreign card with open parameters
Mandatory parameters to perform a payout to a foreign bank card with open parameters collected on your side. Can be used if you have a PCI DSS certificate.
Name | Type | Description |
---|---|---|
payment_method | PaymentMethod | Payment data |
type | string | value: card |
card | CardPaymentMethod | Bank card payment details |
type | string | value: bank_card |
bank_card | BankCard | Unencrypted bank card |
number | string | Card number |
amount_details | AmountDetails | The amount |
amount | int | The amount in ruble decimal format. The value must be greater than zero. If you are sending 100 rubles, you will need to specify 10000 |
currency | string | The ISO 4217 currency code. Case insensitive. Always: rub |
participant_details | ParticipantDetails | Information on payout participants |
sender | Participant | Sender's details. Important: Sender is an individual. |
full_name | string | Name |
company_name | string | Company name |
address_line | string | Address |
country_iso3 | string | The country (ISO-3166-1 alpha-3) |
city | string | The city |
recipient | Participant | Recipient's details |
full_name | string | Recipient's name |
How to perform the payout
There are two ways:
- via the widget, which means that tokenized parameters are passed (without PCI DSS);
- with open parameters (if you have PCI DSS).