Order Status Codes
The numeric codes returned in an order's status field, and what each one means
An order’s status — whether you filter on it or read it back from the API — is a numeric code describing the order’s current condition.
| Code | Enum | Description |
|---|---|---|
1 | UNSENT | A future order that will be processed when its place date arrives. |
3 | REJECTED | The order was rejected after the retry limit was reached. |
4 | CANCELLED | The order was cancelled before it was successfully processed. |
5 | SUCCESS | The order was processed successfully. |
6 | SEND_NOW | A future order already exists for this subscription before the placement process runs. |
9 | PENDING_BATCH_RESPONSE | Ordergroove has sent the order and is awaiting a response file. Applies only to merchants on legacy file-based batch placement, not to API-based placement. |
10 | PENDING_VERIFICATION | Awaiting confirmation from the merchant or ecommerce platform that the order was processed. |
11 | PENDING_PLACEMENT | The order is queued and will be processed shortly. |
12 | EXCEPTION_DURING_PLACEMENT_PREPARATION | Something failed before the order could be attempted. |
13 | CONNECTION_ERROR_DURING_PLACEMENT | The connection failed mid-placement, so the outcome is unconfirmed. Depending on your configuration the order may be retried on the next placement, with no retry limit. |
14 | RESPONSE_PROCESSING_ERROR | The merchant’s batch or HTTP response wasn’t understood. This order isn’t retried. |
15 | GENERIC_ERROR_RESPONSE | A generic error was returned or defaulted. You control how many times these are retried. |
17 | MERGED | The order was merged into another. The target order ID is in the order’s extra data, under merged_order_id. |
18 | CREDIT_CARD_RETRY | The order failed with a 140 error code and is in the credit card retry process. |
19 | AWAITING_RETRY_INSTRUCTIONS | The rejection has been classified and rejected_error_code now holds the three-character Ordergroove code. This state resolves quickly. |
20 | AWAITING_RESPONSE_CLASSIFICATION | The order was rejected and is awaiting classification. While in this state rejected_error_code may hold a raw platform code such as PAYMENT_METHOD_DECLINED rather than an Ordergroove code — treat it as null until classification completes, typically within a minute. |