docs
КабинетПолучить ключи
Начало работы

Быстрый старт

От ключа до первой ссылки на оплату — четыре шага.

1. Получите ключи

Войдите в личный кабинет и в разделе «Настройки» скопируйте API-ключ (передаётся в заголовкеX-Api-Key) и секрет (нужен для проверки подписи вебхуков).

Храните секрет в безопасности

Ключ и секрет дают полный доступ к приёму платежей. Держите их только на сервере, в переменных окружения.

2. Укажите callback URL

Чтобы получать уведомления об оплате, задайте callback_url — в кабинете (значение по умолчанию) или прямо в теле запроса. Без него платёж создать нельзя.

3. Создайте платёж

POST/integration/transactions

Сумма указывается в минорных единицах (копейки/центы): 49900 = 499,00 ₽.

201 Created
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 мес.",
    "callback_url": "https://shop.example/webhooks/cashera",
    "success_url": "https://shop.example/pay/ok",
    "fail_url": "https://shop.example/pay/fail"
  }'

4. Перенаправьте клиента

Отправьте покупателя на payment_url из ответа. После оплаты он вернётся на вашsuccess_url, а на callback_url придёт вебхук со статусом paid.

Не доверяйте только редиректу

Возврат клиента на success_url — не гарантия оплаты. Считайте заказ оплаченным только после вебхука paid или подтверждения через запрос статуса.

Что дальше