Skip to content

Report TX

POST /api/v1/pay/order/{id}/tx

Frontend reports tx_hash — called after the user's wallet sends the TX. Transitions the order status from waiting_paymentsettling.

Works for both Direct and CrossChain orders.

Request

POST /api/v1/pay/order/550e8400-e29b-41d4-a716-446655440000/tx
{
  "tx_hash": "0xabc123..."
}

Response — Success

{
  "ok": true,
  "status": "settling"
}

Response — Failure

Order is not in waiting_payment status or does not exist:

{ "error": "Order not in waiting_payment status or not found" }

HTTP 409 Conflict.