Fetch an order by your reference
Look up an order by your `reference`. Returns the open order if there is one, otherwise the most recent. Use this to reconcile.
Authorization
KeyID Timestamp Nonce Signature X-Gyvar-Key<token>
Your key id, gyv_k_live_... or gyv_k_sandbox_....
In: header
X-Gyvar-Timestamp<token>
Unix seconds. Must be within 5 minutes of our clock.
In: header
X-Gyvar-Nonce<token>
A unique value per request. Replays are rejected.
In: header
X-Gyvar-Signature<token>
Ed25519 signature over the canonical string. See the Signing guide.
In: header
Path Parameters
reference*string
The reference you sent when creating the order.
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/checkout/orders/reference/order_1001"{ "data": { "id": "7b1f9a2c-4e5d-4a8b-9c3f-2d6e1a4b7c90", "status": "open", "kind": "checkout", "reference": "order_1001", "description": "Order #1001 at Kente & Co", "amount": "125.50", "amount_minor": "12550", "currency": "GHS", "currency_decimals": 2, "quantity": 0, "unit_amount": "string", "unit_amount_minor": "string", "settled": { "asset": "USDT", "chain": "tron", "network": "onchain", "quoted": "8.120000", "quoted_minor": "8120000", "received": "8.120000", "received_minor": "8120000", "short_by": "string", "short_by_minor": "string", "over_by": "string", "over_by_minor": "string" }, "late": true, "url": "https://pay.gyvar.com/chk_live_7b1f9a2c-4e5d-4a8b-9c3f-2d6e1a4b7c90", "success_url": "http://example.com", "cancel_url": "http://example.com", "metadata": {}, "expires_at": "2019-08-24T14:15:22Z", "paid_at": "2019-08-24T14:15:22Z", "created_at": "2019-08-24T14:15:22Z", "customer_id": "160c0c4b-9966-4dc1-a916-8407eb10d74e" }}