Если вы используете Сплитование платежей, вы можете создавать чек прихода, чек возврата прихода и чек зачета предоплаты от имени магазина, в котором пользователь приобрел товар. Для этого всем магазинам, с которыми вы работаете, нужно подключить сценарий отправки чеков Сначала платеж, потом чек.
Чтобы сформировать чек прихода, отправьте ЮKassa запрос на создание чека . Обязательно передайте в нём
on_behalf_of
с идентификатором магазина, от лица которого хотите отправить чек, payment_id
с идентификатором платежа, который приняли от пользователя, и type
со значением payment
(чек прихода).Пример запроса на создание чека прихода
curl https://api.yookassa.ru/v3/receipts \ -X POST \ -u <Идентификатор магазина>:<Секретный ключ> \ -H 'Idempotence-Key: <Ключ идемпотентности>' \ -H 'Content-Type: application/json' \ -d '{ "customer": { "email": "user@example.com", "phone": "79000000000" }, "type": "payment", "payment_id": "24e89cb0-000f-5000-9000-1de77fa0d6df", "on_behalf_of": "123", "send": true, "items": [ { "description": "Платок Gucci", "quantity": "1.00", "amount": { "value": "3000.00", "currency": "RUB" }, "vat_code": 2, "payment_mode": "full_prepayment", "payment_subject": "commodity" } ], "tax_system_code": 1, "settlements": [ { "type": "cashless", "amount": { "value": "3000.00", "currency": "RUB" } } ] }'
В ответ ЮKassa отправит вам объект чека в актуальном статусе. Помимо основных параметров в ответе вернется
on_behalf_of
c идентификатором магазина, от имени которого вы отправляете чек.Пример объекта чека
{ "id": "rt-2da5c87d-0384-50e8-a7f3-8d5646dd9e10", "type": "payment", "payment_id": "24e89cb0-000f-5000-9000-1de77fa0d6df", "on_behalf_of": "123", "status": "pending", "items": [ { "description": "Платок Gucci", "quantity": 1.000, "amount": { "value": "3000.00", "currency": "RUB" }, "vat_code": "2", "payment_mode": "full_prepayment", "payment_subject": "commodity" } ], "settlements": [ { "type": "cashless", "amount": { "value": "3000.00", "currency": "RUB" } } ], "tax_system_code": 1 }
Чек возврата прихода необходимо формировать в следующих случаях:
- при возврате успешного платежа;
- при частичном подтверждении или отмене двухстадийного платежа, для которого был создан чек прихода.
Чек для возврата создается аналогично чеку прихода, но в запросе вместо
payment_id
с идентификатором платежа необходимо передать refund_id
с идентификатором возврата, а в параметре type
— значение refund
(чек возврата прихода).Чтобы сформировать чек возврата прихода для отмененного или частично подтвержденного платежа, в запросе на создание чека нужно передать параметр
type
со значением refund
и payment_id
с идентификатором этого платежа.При создании чека зачета предоплаты передайте в запросе дополнительный параметр
on_behalf_of
с идентификатором магазина, на счет которого перечислены деньги.Пример запроса на создание чека зачета предоплаты
curl https://api.yookassa.ru/v3/receipts \ -X POST \ -u <Идентификатор магазина>:<Секретный ключ> \ -H 'Idempotence-Key: <Ключ идемпотентности>' \ -H 'Content-Type: application/json' \ -d '{ "customer": { "email": "user@example.com", "phone": "79000000000" }, "payment_id": "24e89cb0-000f-5000-9000-1de77fa0d6df", "on_behalf_of": "123", "type": "payment", "send": "true", "items": [ { "description": "Платок Gucci", "quantity": "1.00", "amount": { "value": "3000.00", "currency": "RUB" }, "vat_code": "2", "payment_mode": "full_payment", "payment_subject": "commodity" } ], "settlements": [ { "type": "prepayment", "amount": { "value": "3000.00", "currency": "RUB" } } ] }'
В ответ ЮKassa отправит вам объект чека в актуальном статусе.
Пример объекта чека зачета предоплаты
{ "id": "rt_1da5c87d-0984-50e8-a7f3-8de646dd9ec9", "type": "payment", "payment_id": "24e89cb0-000f-5000-9000-1de77fa0d6df", "on_behalf_of": "123", "status": "pending", "items": [ { "description": "Платок Gucci", "quantity": 1.000, "amount": { "value": "3000.00", "currency": "RUB" }, "vat_code": "2", "payment_mode": "full_payment", "payment_subject": "commodity" } ], "settlements": [ { "type": "prepayment", "amount": { "value": "3000.00", "currency": "RUB" } } ] }
Получение информации о магазине продавца по APIПрием платежейВозврат платежейОплата с соблюдением требований 54-ФЗ