PayOut | SBP

Payout via SBP to a phone number. Pass the recipient bank in bank.

To create a payout with the SBP method, send a request (curl example):

curl -X POST https://api.bopay.io/v1/payouts \
  -H "Content-Type: application/json" \
  -H "X-Identity: <API-key>" \
  -H "X-Signature: <Signature>" \
  -d '{
  "ext_id": "payout_001",
  "amount": 3000,
  "method": "sbp",
  "requisites": "+79001234567",
  "holder_name": "Petr Petrov",
  "bank": "tinkoff",
  "notify_url": "https://merchant.example/payout-webhook"
}'

POST /v1/payouts — headers and signature: Authorization.

Parameters

Field	Type	Required	Description
`ext_id`	string	yes	Your order ID, unique
`amount`	number	yes	Amount in RUB, within terminal limits
`method`	string	yes	`sbp`
`requisites`	string	yes	Recipient phone number
`holder_name`	string	no	Recipient full name
`bank`	string	no	Bank code from the directory
`client_id`	string	no	Payer ID on your side
`notify_url`	string	no	URL for notifications

The response contains the payout:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "ext_id": "payout_001",
  "amount": 3000,
  "currency": "RUB",
  "rate": 92.5,
  "amount_usdt": 32.43,
  "method": "sbp",
  "requisites": "+79001234567",
  "holder_name": "Petr Petrov",
  "bank": "tinkoff",
  "status": "processing",
  "created_at": "2026-01-30T12:45:00Z"
}

Statuses, fields and errors — see Create Payout. Result — webhook.

Parameters​

Parameters