Документация для мерчантов

Интеграция построена по принципу server-to-server: ваш бэкенд создаёт платёж одним запросом, получает payment_url и перенаправляет на него клиента. О финальном статусе вы узнаёте из подписанного вебхука, а текущее состояние всегда можно запросить по uuid или вашему external_id.

Как это работает

1. Клиент оформляет заказ у вас на сайте.
2. Ваш сервер вызывает POST /integration/transactions с суммой, валютой и методом оплаты.
3. В ответ приходит транзакция со статусом pending и ссылкой payment_url.
4. Вы перенаправляете клиента на payment_url для оплаты.
5. После оплаты Cashera отправляет вебхук на ваш callback_url и переводит статус в paid.
6. Сумма за вычетом комиссии конвертируется в USDT и зачисляется на баланс мерчанта.

Первый запрос

Минимальный пример создания платежа на 499,00 ₽ через СБП:

curl -X POST https://api.cashera.cash/api/v1/integration/transactions \
  -H "X-Api-Key: $CASHERA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 49900,
    "currency": "RUB",
    "payment_method": "sbp",
    "external_id": "order-10428"
  }'

С чего начать