Выплаты по СБП

Создание выплаты, проверка получателя по PAM, подтверждение операции и получение финального статуса.

Мерчант создаёт заявку через POST /out/sbp-transfer. Vepay запрашивает PAM в банке и сверяет ФИО. До завершения проверки мерчант опрашивает POST /out/state. Подтверждение выполняется только при результате MATCH.

Создание заявки

Мерчант создаёт операцию выплаты через СБП.

POST /out/sbp-transfer

{
  "client": {
    "firstName": "Иван",
    "middleName": "Иванович",
    "lastName": "И"
  },
  "phone": "79000000000",
  "bic": "044525225",
  "amount": 100000,
  "extid": "string"
}

Проверка получателя

Vepay запрашивает PAM в банке и сверяет маскированное ФИО с данными заявки.

Мерчант Создаёт заявку POST /out/sbp-transfer
Vepay Запрашивает PAM phone + bic → банк
Банк Возвращает PAM маскированное ФИО
Vepay Сверяет ФИО ФИО заявки ↔ PAM

Блок-схема сверки ФИО Показать схему

Сверка PAM и ФИО

Vepay получает маскированное ФИО от банка, сопоставляет его с данными заявки и передаёт результат мерчанту через POST /out/state.

Мерчант Создаёт заявку на выплату POST /out/sbp-transfer: client, phone, bic, amount, extid
Vepay Регистрирует операцию
Vepay → Банк Запрашивает PAM phone, bic
Банк → Vepay Возвращает PAM маскированное ФИО: Иван Иванович И
Vepay Сверяет ФИО и PAM Иван Иванович И ↔ Иван Иванович И

Параллельно с проверкой

Мерчант → Vepay Повторяет POST /out/state

Vepay → Мерчант checkResult = CHECKING

↻ Пока идёт проверка, запрос POST /out/state повторяется.

Vepay → Мерчант Ответ POST /out/state: MATCH или MISMATCH При MATCH: readyToConfirm = true. При MISMATCH: readyToConfirm = false.

Параллельно с проверкой

Мерчант опрашивает статус

До готовности результата мерчант повторяет запрос POST /out/state с идентификатором операции.

{
  "id": 12345
}

Результат проверки в ответе `POST /out/state`
checkResult	Ответ Vepay	Действие мерчанта
CHECKING	Проверка ФИО выполняется. `readyToConfirm = false`.	Повторить `POST /out/state`.
MATCH	ФИО совпали. Vepay возвращает `pam` и `readyToConfirm = true`.	Вызвать `POST /out/sbpConfirm`.
MISMATCH	ФИО не совпали. `readyToConfirm = false`.	Не подтверждать выплату. Создать новую заявку с корректными данными.

Подтверждение выплаты

Мерчант подтверждает выплату только после получения результата MATCH.

POST /out/sbpConfirm

Мерчант Получил MATCH через /out/state
Мерчант → Vepay Отправляет подтверждение: POST /out/sbpConfirm
Vepay → Банк-эквайер Передаёт запрос подтверждения выплаты
Банк-эквайер Подтверждает и исполняет выплату

{
  "id": 12345
}

Финальный статус

После подтверждения мерчант продолжает опрашивать POST /out/state.

POST /out/state

Статусы исполнения выплаты
sbpCode	Значение	Действие мерчанта
RCVD	Выплата в обработке.	Продолжать опрос `POST /out/state`.
ACWP	Выплата выполнена.	Зафиксировать успешную выплату.
RJCT	Выплата отклонена.	Зафиксировать отказ и обработать ошибку.

Лог ответа на финальный статус

Пример полного ответа Vepay на POST /out/state.

[
    'body' => '{"id":"2321645546"}',
    'return' => [
        'status' => 1,
        'serviceName' => 'Выплата через СБП',
        'message' => 'Успех',
        'rc' => null,
        'channel' => 'TKB',
        'cardNumber' => null,
        'cardType' => null,
        'issuingBank' => 'Сбербанк',
        'paymentDate' => '29.09.2026 16:57:32',
        'uuid' => '79ad3f64-f52b-42e2-a2fd-af906f5dc758',
        'sbpOperId' => 'A62721357254590Y0B10040011851301',
        'sbpCode' => '',
        'rrn' => null,
        'memberId' => '100000000111',
        'inn' => null,
        'card' => null,
        'sndPhone' => '79000000000',
        'pam' => 'Иван Иванович И',
        'additionalFields' => [
            'field1' => null,
            'field2' => null,
            'field3' => null,
        ],
    ],
]