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

Базовый адрес

https://api.cashera.cash/api/v1

Авторизация

заголовок X-Api-Key

Суммы

целые числа в минорных единицах

Интеграция построена по принципу server-to-server: ваш бэкенд создаёт платёж одним запросом, получает payment_url и перенаправляет на него клиента. Все запросы идут по HTTPS, тело и ответы в формате JSON. О финальном статусе вы узнаёте из подписанного вебхука, а текущее состояние всегда можно запросить по 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",
    "description": "Подписка Pro, 1 мес."
  }'

С чего начать