Order status and notifications
There are two ways to know what happened to an order.
1. Ask for the status. Call getOrderStatus(sessionId) from the SDK (or the matching API endpoint) with the session ID you received from createSession. Use it when the customer returns to your shop, to confirm that the escrow was really created before showing a success message.
2. Webhooks (server notifications). In the API key settings you can enter a webhook URL. The intended behaviour is that RahaKaitse sends a JSON POST to it on each change, for example:
{
"event": "escrow.created",
"sessionId": "session_…",
"orderId": 123,
"status": "accepted",
"amount": "149.99",
"currency": "USDC",
"buyerWallet": "0x…",
"sellerWallet": "0x…",
"timestamp": "2026-01-01T12:00:00Z"
}
Events: escrow.created, escrow.completed, escrow.disputed, escrow.refunded. Webhook delivery is being rolled out. Until it is enabled for your account, use getOrderStatus to confirm orders.
Best practice: always verify an order's real status with getOrderStatus or on the blockchain before you ship, and never rely only on the customer's browser returning to your thank-you page.