/api/v1/orders tenant keyTenant fulfillment, step 2. Requires a TENANT API key. Commits a PENDING_PAYMENT order (from POST /shipping-quote) to one of its quoted rate_ids: starts redemption for every card on the order and locks in the chosen rate. You’re billed exactly what that rate quoted. Returns 201.
POST /api/v1/orders money These inputs are shared across all docs pages — an id entered here carries over.
{
"order_id": 0,
"rate_id": ""
}Not run yet — press Run to make a live call against https://service.rip.fun (through this demo's server-side proxy; the API key never reaches the browser).
curl -X POST 'https://service.rip.fun/api/v1/orders' \
-H 'X-API-Key: rip_…' \
-H 'Content-Type: application/json' \
-d '{"order_id":0,"rate_id":""}' | Field | Type | Required | Description |
|---|---|---|---|
order_id | number | yes | The PENDING_PAYMENT order id from /shipping-quote (tenant_order_id also accepted) |
rate_id | string | yes | A rate_id from that order's quoted rates[] |
data)| Field | Description |
|---|---|
order_id / status | The committed order + its new status |
unique_ids | Cards on the order |
shippo_rate_id | The committed (quoted) rate id |
shippo_shipment_id / shippo_address_id | Shippo shipment + address object ids |
ship_by_at | Target ship date |
| Status | Code | When |
|---|---|---|
| 400 | order_id required | order_id missing / not a positive integer |
| 400 | rate_id required | rate_id missing or empty |
| 404 | order not found | no such order for this tenant |
| 400 | card not redeemable | a card on the order cannot begin redemption (RawCardIntakeError) |
| 409 | already submitted | order is not PENDING_PAYMENT (already committed / cancelled) |
See Errors for the response envelope and the full code list.