Перейти к основному содержимому

Выплаты по номеру телефона через СБП

Вы можете отправить выплату физическому лицу, используя его номер телефона в Системе быстрых платежей (СБП).

Дополнительные проверки​

  • Проверка регистрации получателя в СБП — используйте метод fps/customer_verification. Делать это перед каждым переводом необязательно: достаточно однократной проверки при первом использовании реквизитов.
  • Получение списка банков-участников СБП — используйте метод fps/banks, чтобы проверить, подключен ли нужный банк к СБП.

Параметры​

НазваниеОбязательностьТипОписание
payout_info+objectПлатежные данные
  type+stringзначение: account_info
  account_info+objectБанковский счет
    payment_system+stringСистема банковских платежей. Всегда: fps_info
    fps_info+objectДанные СБП
      phone_number+stringТелефон получателя
      bank_identifier+stringИдентификатор банка получателя в СБП
      money_purpose+stringНазначение выплаты
sum_info+objectСумма
  sum+intСумма в копейках. Значение должно быть больше нуля. Если отправляете 100 рублей, нужно передать 10000
  currency_code+stringКод валюты согласно ISO 4217. Регистр не важен. Всегда: rub

Как сделать выплату на карту через СБП​

1. Создайте платежную сессию​

Отправьте запрос на создание сессии transaction/initiate. В ответе придет идентификатор платежной сессии.

2. Начните выплату​

Отправьте запрос на проведение выплаты с помощью метода transaction/start/transfer.

Пример
  curl -X POST \
    https://proxy-demo.zetplat.com/api/v1/transaction/start/transfer \
    -H 'Content-Type: application/json' \
    -H 'X-Project-Id: your_project_name' \
    -H 'X-Signature: signature' \
    -d '{
      "session_id": "ps_2704",
      "payout_info": {
        "type": "account_info",
        "account_info": {
          "payment_system": "fps_info",
          "fps_info": {
            "phone_number": "79680000000",
            "bank_identifier": "100000000069",
            "money_purpose": "Перевод средств по договору № 5015553111 Иванов Иван Иванович НДС не облагается"
          }
        }
      },
      "sum_info": {
        "sum": 30000,
        "currency_code": "rub"
      },
      "extra_info": "good"
    }'

3. Дождитесь вебхука для выплаты​

Zetplat отправит вам вебхук approve_pending и будет ждать подтверждения или отмены.

4. Подтвердите или отмените выплату​

Проверьте данные для выплаты, а затем подтвердите или отмените ее:

5. Дождитесь результата выплаты​

Zetplat отправит вам вебхук checkout_results. Статус successful означает успешную выплату.

Подробнее о статусах выплаты
Описание кодов ошибок и их значений