Payouts to Russia
You can carry out payouts to Russian bank accounts belonging to individuals, legal entities, and self-employed people. All the parameters are passed in the clear.
Payouts to the accounts of legal entities are available only for non-residents of the Russian Federation.
Allowed accounts
You can only send payouts to the accounts that begin with the following numbers:
- 40817810
- 42301810
- 42302810
- 42303810
- 42304810
- 42305810
- 42306810
- 42307810
- 40802810
- 40502810
- 40820810
- 40702810 (for the accounts of legal entities)
If the account begins with another number, the payout will fail.
Payout parameters
- Legal entities, self-employed people
- Individuals
Name | Mandatory | Type | Description |
---|---|---|---|
payment_method | + | object | Payout data |
type | + | string | Value: bank_account |
bank_account | + | object | Bank account |
system_type | + | string | Value: ru |
ru | + | object | Bank account details |
bik | + | string | Recipient's bank's BIC |
account | + | string | Recipient's bank account |
full_name | + | string | For payouts to an account of a sole proprietor: ИП . For payouts to a legal entity, enter the entity's name if it is provided in the agreement. Important: if the name is incorrect, the recipient bank may cancel the payout |
description | + | string | Purpose of the payout accompanied by the monetary transaction code. For details, see How to specify the remittance purpose |
inn | + | string | Recipient's INN (10 digits for legal entities, 12 digits for individuals) |
kpp | - (mandatory for payouts to the accounts of legal entities) | string | Recipient's Tax Registration Reason Code (KPP) |
amount_details | + | object | Payout amount details |
amount | + | int | Payout amount in decimal format. The value must be greater than zero. To send 100 rubles, write 10000 |
currency | + | string | Currency code according to ISO 4217. Case insensitive |
participant_details | + | object | Information on the payout participants |
sender | + | object | Sender details |
full_name | - (mandatory for individuals) | string | Sender’s full name |
company_name | - (mandatory for businesses) | string | Sender company name |
address_line | + | string | Sender's address |
country_iso3 | + | string | Sender’s country code (ISO-3166-1 alpha-3) |
city | + | string | Sender's city |
recipient | + | object | Recipient details |
full_name | + | string | Recipient's full name |
Name | Mandatory | Type | Description |
---|---|---|---|
payment_method | + | object | Payout data |
type | + | string | Value: bank_account |
bank_account | + | object | Bank account |
system_type | + | string | Value: ru |
ru | + | object | Bank account details |
bik | + | string | Recipient's bank's BIC |
account | + | string | Recipient's bank account |
full_name | + | string | Individual's full name as it is registered in the bank (in Cyrillic or Latin). Important: if the name is incorrect, the recipient bank may cancel the payout |
description | + | string | Purpose of the payout accompanied by the monetary transaction code. For details, see How to specify the remittance purpose |
amount_details | + | object | Payout amount details |
amount | + | int | Payout amount in decimal format. The value must be greater than zero. To send 100 rubles, write 10000 |
currency | + | string | Currency code according to ISO 4217. Case insensitive |
participant_details | + | object | Information on the payout participants |
sender | + | object | Sender details |
full_name | - (mandatory for individuals) | string | Sender’s full name |
company_name | - (mandatory for businesses) | string | Sender company name |
address_line | + | string | Sender's address |
country_iso3 | + | string | Sender’s country code (ISO-3166-1 alpha-3) |
city | + | string | Sender's city |
recipient | + | object | Recipient details |
full_name | + | string | Recipient's full name |
How to specify the remittance purpose
According to the Russian law, in the payout purpose (bank_account_ru.description
) the following must be specified:
- type of operation (e.g. service fee)
- reason for the payment (e.g. agreement number)
- products and/or services provided
- whether VAT is applicable
You will also need to add a currency transaction code in the following format: {VO<currency transaction code>}
without any indents or spaces. The code has to be confirmed with your manager in advance.
The payout purpose must not contain the following characters: ?
and !
. The maximum length is 210 characters.
An example of a payout purpose:
{VO99090} Wire for agreement No. 5015553456 Ivanov Ivan Ivanovich VAT exempt
Example
- Legal entities, self-employed people
- Individuals
curl -X POST \
https://demo.smart-glocal.com/api/v1/session/start/payout \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"session_id": "ps_1053680",
"payment_method": {
"type": "bank_account",
"bank_account": {
"system_type": "ru",
"ru": {
"bik": "044525971",
"account": "********************",
"full_name": "Receiving company name",
"description": "{VO99090} Wire for agreement No. 5015553456 Ivanov Ivan Ivanovich VAT exempt",
"inn": "7806577406",
"kpp": "780501001"
}
}
},
"amount_details": {
"amount": 10000,
"currency": "rub"
},
"metadata": "good",
"participant_details": {
"sender": {
"company_name": "Sending company name",
"address_line": "Sending company's address line",
"country_iso3": "USA",
"city": "New York"
},
"recipient": {
"full_name": "Receiving company name"
}
}
}'
curl -X POST \
https://demo.smart-glocal.com/api/v1/session/start/payout \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"session_id": "ps_1053680",
"payment_method": {
"type": "bank_account",
"bank_account": {
"system_type": "ru",
"ru": {
"bik": "044525971",
"account": "********************",
"full_name": "Ivanov Ivan Ivanovich",
"description": "{VO99090} Payment from Company by Invoice No.*** for online education VAT exempt"
}
}
},
"amount_details": {
"amount": 10000,
"currency": "rub"
},
"metadata": "good",
"participant_details": {
"sender": {
"full_name": "John Johnson",
"address_line": "123 Main Street",
"country_iso3": "USA",
"city": "New York"
},
"recipient": {
"full_name": "Ivanov Ivan Ivanovich"
}
}
}'