Via FPS by a phone number
You may make a payout to an account of an individual by their phone number via Faster Payment System (FPS).
To make payouts via FPS, you need to open a current account in Bank 131. After that the Bank signs you up to the Faster Payment System.
If you need to check whether a recipient is registered in FPS before making a payout, call the fps/customer_verification method. It is optional and we recommend that you use it only when a payout is made to new payment details for the first time.
To see the up-to-date list of banks participating in FPS, visit the official FPS site.
Mandatory payout parameters
Name | Type | Description |
---|---|---|
payment_method | PaymentMethod | Payment data |
type | string | value: bank_account |
bank_account | BankAccountPaymentMethod | Bank account |
system_type | string | Bank transfer system Always: faster_payment_system |
faster_payment_system | FasterPaymentSystem | FPS data |
phone | string | Recipient's phone number |
bank_id | string | Identifier of the recipient's bank in FPS |
description | string | Payout purpose How to set this out |
amount_details | AmountDetails | Amount |
amount | int | 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 | Currency code according to ISO 4217. Case insensitive. Always: rub |
How to perform the payout
The payout is performed as in the general scenario. Open parameters are passed. You do not need to use the widget.
Payout via FPS request example
curl --location --request POST 'https://demo.bank131.ru/api/v1/session/init/payout' \
--header 'Content-Type: application/json' \
--header 'X-PARTNER-SIGN: sign' \
--header 'X-PARTNER-PROJECT: test-partner' \
--data-raw '{
"session_id": "ps_2704",
"payment_method": {
"type": "bank_account",
"bank_account": {
"system_type": "faster_payment_system",
"faster_payment_system": {
"phone": "79680000000",
"bank_id": "100000000069",
"description": "Wire for agreement № 5015553111 Ivanov Ivan Ivanovich VAT exempt"
}
}
},
"amount_details": {
"amount": 30000,
"currency": "rub"
},
"metadata": "good"
}'