Orders
List orders
Return a paginated list of orders across your sub-merchants. Every order carries the merchant_id of the sub-merchant it belongs to; use the merchant_id filter to narrow the list to a single sub-merchant.
get/orders
Request
- Base URLhttps://app-sandbox.resolvepay.com/api
- Auth
- HTTP bearer
- or HTTP basic
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
limitinteger
Limit the number of orders returned.
pagestring
Specify the page of orders returned.
Filter orders by the specified fields.
Filter semantics: filter[field][operator]=value.
Available filter operators:
- eq - equal (=)
- gt - greater than (>)
- gte - greater than or equal (>=)
- lt - less than (<)
- lte - less than or equal (<=)
Filtering is allowed by the following fields:
- merchant_id (eq) - the sub-merchant the order belongs to
- status (eq)
- order_number (eq)
- po_number (eq)
- customer_id (eq)
- authorized_at (eq, gt, lt, gte, lte)
- amount_authorized (eq, gt, lt, gte, lte)
- amount_captured (eq, gt, lt, gte, lte)
- amount_canceled (eq, gt, lt, gte, lte)
- amount_remaining (eq, gt, lt, gte, lte)
Example: filter[merchant_id][eq]=MER456789&filter[status][eq]=authorized
Note: filter with the eq operator is equivalent to filter[field]=value
Response
A paginated list of orders across your sub-merchants.
Example response
{
"count": 1,
"limit": 25,
"page": 1,
"results": [
{
"id": "ORDlaE5wbg0",
"merchant_id": "MER456789",
"checkout_id": "CHKabc123",
"number": "ord_100001",
"po_number": "PO-555",
"advance_requested": true,
"source": "checkout",
"status": "authorized",
"amount_authorized": 1000,
"amount_captured": 500,
"amount_remaining": 500,
"first_captured_at": "2024-01-15T10:00:00.000Z",
"line_items": [
{
"name": "Widget A",
"quantity": 2,
"unit_price": 50,
"sku": "ABC-123",
"total_price": 100,
"type": "product",
"tax_amount": 8.5
}
],
"authorization_expires_at": "2024-02-15T10:00:00.000Z",
"authorization_expiry_source": "system",
"authorized_at": "2024-01-01T00:00:00.000Z",
"updated_at": "2024-01-15T10:00:00.000Z",
"customer": {
"id": "X50sgfRd",
"name": "Acme Corp",
"remaining_credit": 5000
}
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.