WinWallet Merchant API Help

Создание заказа и приём оплаты

Сценарий интеграции: от корзины на сайте мерчанта до подтверждённой оплаты.

Полный сценарий оплаты

  1. Сгенерируйте уникальный merchant_transaction_id для заказа в вашей системе.

  2. Вызовите POST /invoice/create с суммой, позициями и URL редиректов.

  3. Сохраните invoice_id в заказе и откройте invoice_url для пользователя.

  4. Дождитесь webhook на callback_url со статусом 2 (PAID) или опрашивайте GET /invoice/status.

  5. Выдайте товар/услугу только после подтверждения PAID. При статусе 3 (EXPIRED) или 4 (CANCELED) предложите повторную оплату — новый инвойс с новым merchant_transaction_id.

Отмена до оплаты

Если пользователь отказался от оплаты, вызовите POST /invoice/cancel пока статус PENDING.

01 июня 2026