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/payout_details | + | 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/payout_details | + | 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"
}
}
}'
Speedy payouts to accounts in Russian banks (via BESP)
You can make speedy payouts to accounts in Russian banks through the BESP system. A speedy payout takes place within an hour, a regular one—from 2 hours to 1 banking day (the crediting period depends on the recipient's bank).
The fees for regular and speedy payouts differ and are fixed in your agreement with Smart Glocal.
How to enable
To be able to make speedy payouts to accounts in Russian banks through the BESP system, contact your manager at Smart Glocal.
How to make a payout via BESP
In the payout request, pass true
in the ru
object in the is_fast
field, and your payout will be sent through BESP.
If you do not specify this parameter, a regular payout will be sent.
Example
"bank_account": {
"system_type": "ru",
"ru": {
"bik": "044525971",
"account": "40817810100000270411",
"full_name": "Ivanov Ivan Ivanovich",
"description": "Wire for agreement № 5015553111 Ivanov Ivan Ivanovich VAT exempt",
"is_fast": "true"
}
}
What can go wrong
- If you send a payout in a way that is not in your agreement with Smart Glocal, the payout will not go through. The response be received as a
routing_internal_error
. - If you send a speedy payout to a bank that is not connected to the BESP system, the payout will be sent as a regular one, but you will be charged the fee set for a speedy payout.
Payout refund
The payout you sent to a Russian bank account may be refunded. In this case, you will get a refund within 5 days.
Learn more about payout refunds