Статус заказа и уведомления
Узнать, что произошло с заказом, можно двумя способами.
1. Запросить статус. Вызовите getOrderStatus(sessionId) из SDK (или соответствующий API-метод) с ID сессии, полученным из createSession. Используйте это, когда клиент возвращается в ваш магазин, чтобы убедиться, что эскроу действительно создан, прежде чем показывать сообщение об успехе.
2. Webhook (серверные уведомления). В настройках API-ключа можно указать URL webhook. Задуманное поведение: RahaKaitse отправляет на него JSON POST при каждом изменении, например:
{
"event": "escrow.created",
"sessionId": "session_…",
"orderId": 123,
"status": "accepted",
"amount": "149.99",
"currency": "USDC",
"buyerWallet": "0x…",
"sellerWallet": "0x…",
"timestamp": "2026-01-01T12:00:00Z"
}
События: escrow.created, escrow.completed, escrow.disputed, escrow.refunded. Отправка webhook внедряется поэтапно. Пока она не включена для вашей учётной записи, подтверждайте заказы с помощью getOrderStatus.
Лучшая практика: перед отправкой всегда проверяйте реальный статус заказа через getOrderStatus или в блокчейне и не полагайтесь только на то, что браузер клиента вернётся на вашу страницу «спасибо».