SBP

How to use SBP to submit a payout in Russia.

Post

https://sandbox.luxtak.com/api/payout

Submit a payout by SBP in Russia

This endpoint allows you to submit a payout by SBP in Russia.

Parameters

NameTypeDescription
Content-Type*stringapplication/json; chartset=UTF-8
AppId*stringYour App ID in payout platform
Authorization*stringSHA256($sorted_params + $app_key)

Body

NameTypeDescription
name*stringBeneficiary's name
- Length between 5 and 100 -
bank_code*stringBank code.
- Get from /bank-account-list api, use "country": "RUS". "method": "SBP" Check here -
account_type*stringAccount type
- Fixed Value: phone -
account*stringAccount
fee_bear*stringOne of [beneficiary
amount*numberPayout Amount
- Min 1, Max 250,000 -
amount_typestringSpecify the amount value is fixed for merchant or beneficiary
- One of: source_amount, arrival_amount(default) -
source_currency*stringMerchant Account Currency
- supported: USD, GBP, EUR, PEN -
arrival_currency*stringBeneficiary's account currency.
Fixed value: RUB
notify_url*stringWhere luxtak will send notification to.
custom_code*stringMerchant Payout ID
- Max. 50 chars -
additional_remark*stringAdditional Remark
- Max length: 40 -
country*stringFixed value: RUS, for Russia
method*stringFixed value: SBP

Responses

200: OKsubmit successfully
{
  "code": 200,
  "msg": "success",
  "time": 1628580845,
  "data": {
    "id": "TS202412110734054iRiUZFPXfQM",
    "custom_code": "custom_code1005721520372911sPn0",
    "arrival_amount": "1.01",
    "arrival_currency": "RUB",
    "source_amount": "0.01",
    "source_currency": "USD",
    "status": "IN_PROCESSING"
  }
}
400: Bad Requestorder already existed
{
  "code": 4001020,
  "msg": "order already existed",
  "time": 1628580940,
  "data": {}
}
401: Unauthorizedunauthorized
{
    "code": 4004003,
    "msg": "permission denied",
    "time": 1637224716,
    "data": {}
}
500: Internal Server Errorfee not configured
{
    "code": 5001003,
    "msg": "fee not configured",
    "time": 1637224716,
    "data": {
        ... ...
    }
}
500: Internal Server Errorbalance insufficient
// system error
{
    "code": 5001102,
    "msg": "balance insufficient",
    "time": 1637224716,
    "data": {
        ... ...
    }
}
500: Internal Server Errorsystem error
{
    "code": 5001000,
    "msg": "system error",
    "time": 1637224716,
    "data": {}
}

Example

curl --location --request POST 'https://api.luxtak.com/api/payout'
\
--header 'AppId: 94FAC**********************68548' \
--header 'Authorization:
d6181db0d6548b94b162e75d095b59147172d914699f83b2bd17951a671b6302'\
--header 'Content-Type: application/json' \
--data-raw '{
  "name":"Tatiana Ivanovskay",
  "bank_code": "100000000111",
  "account_type": "phone",
  "account": "79283446260",
  "fee_bear": "merchant",
  "amount": "1.01",
  "source_currency": "USD",
  "arrival_currency": "RUB",
  "notify_url": "https://api.luxtak.com/api/notify/demo",
  "custom_code": "custom_code1005721520372911sPn0",
  "additional_remark": "from test",
  "country": "RUS",
  "method": "SBP"
}

Tips

Note: 94FAC*****************68548 is luxtak's test App ID for sandbox, and d6181db0d6548b94b162e75d095b59147172d914699f83b2bd17951a671b6302 is authorization token associated with the test App ID.

Tips

In sandbox environment, please use **_luxtak_test_reject@luxtak.com_** as SBP account , and EMAIL as account_type for testing REJECTED payout, any other SBP account will be success (PAID).

Example of Document

Document TypeDocument IDDescription
CPF22*******9911 digits
CNPJ23**********3114 digits

Third-party CPF/CNPJ Validator

Example of SBP account

Account TypeAccountDescription
CPF22*******9911 digits
CNPJ23**********3114 digits
Phone+5511987654321 or 11987654321country code (+55) is optional
Emailmerchant@luxtak.com​
EVPA UUID-like string: a1073db4-a3a0-11ed-a8fc-0242ac120002alphanumeric string of 32 digits that is sent from the central bank to the institution