FPS to a phone number
You may make a payout to an account of an individual by their phone number via the 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 an up-to-date list of banks participating in FPS, use our method:
fps/banks
.
Payout parameters
Name | Mandatory | Type | Description |
---|---|---|---|
payment_method | + | object | Payment data |
type | + | string | Value: bank_account |
bank_account | + | object | Bank account |
system_type | + | string | Bank transfer system Always: faster_payment_system |
faster_payment_system | + | object | FPS data |
phone | + | string | Recipient's phone number |
bank_id | + | string | Identifier of the recipient's bank in FPS |
description | + | string | Payout purpose (up to 140 characters). How to set this out |
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 | 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 -X POST 'https://demo.bank131.ru/api/v1/session/init/payout' \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"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"
}'