API сплитования платежей
Передайте раскладку в запросе на оплату — банк проведёт платёж, а доли уйдут участникам по вашей схеме. Документация — на api.yagoda.team.
- APIЗаказы, каталог, промокоды, подписки на карту. Повтор запроса не создаёт дублей.
- ВебхукиОб оплате, неудачной оплате и отмене. Каждый подписан HMAC-SHA256.
- Раскладка в запросеДоли участников передаются вместе с платежом — суммой или процентом.
- Отложенная выплатаскороОтпустите доли одним запросом, когда услуга оказана.
- APIЗаказы, каталог, промокоды, подписки на карту. Повтор запроса не создаёт дублей.
- ВебхукиОб оплате, неудачной оплате и отмене. Каждый подписан HMAC-SHA256.
- Раскладка в запросеДоли участников передаются вместе с платежом — суммой или процентом.
- Отложенная выплатаскороОтпустите доли одним запросом, когда услуга оказана.
API сплитования
Раскладка — в одном запросе
Если доли зависят от заказа, ваша система передаёт их в запросе на оплату. Если правила постоянные — хватит кабинета, программист не нужен.
- API: заказы, каталог, подписки на карту
- Вебхуки с подписью HMAC-SHA256
- Раскладка в запросе на оплату — доли уходят автоматически
Пример. Имена полей условные, точные — в документации API.
POST /v1/payments
Authorization: Bearer sk_live_···
{
"amount": 1240000,
"description": "Заказ № 4812",
"splits": [
{ "recipient": "rcp_supplier_51", "amount": 917600 },
{ "recipient": "rcp_delivery_07", "amount": 99200 }
],
"return_url": "https://shop.example/thanks"
}POST /v1/payments/pay_7Kq2m9/refunds
Authorization: Bearer sk_live_···
{ "amount": 1240000 }
200 OK
{
"id": "rfd_3Lw8x1",
"status": "succeeded"
}POST https://shop.example/yagoda/webhook
{
"event": "split.released",
"payment": "pay_7Kq2m9",
"fee": 25916,
"parts": [
{ "recipient": "rcp_supplier_51", "amount": 917600 },
{ "recipient": "rcp_delivery_07", "amount": 99200 },
{ "recipient": "self", "amount": 197284 }
]
}События вебхуков
Уведомление о каждом событии платежа приходит на ваш сервер — сверка не нужна.
Пример. Имена полей условные, точные — в документации API.
payment.succeeded- Платёж прошёл
refund.succeeded- Возврат проведён
split.held- Доли ждут подтверждения
- скоро
split.released- Доли отправлены участникам
Расскажите, кто участвует в ваших сделках
Предложим схему распределения и поможем принять первый платёж.