Order: Search Billing
get_order_paymentlink_and_billing[Order]
[What it does] Searches authenticated-account order checkout Billing records only; it does not cover subscription or one-time-purchase billing.
[When to use] Use when the user needs to look up order-related payment or billing records, such as checking the billing status tied to an order.
[When not to use] For subscription or Credits billing/invoices, use get_plan_and_credit_billing. This tool never creates a payment link; use the payment-flow-start tool for that. When related_kind=pbl, related_id is a PBL ID and must never be passed to get_order as dsers_order_id.
[How to use] billing_id gives an optional exact lookup (skips the default time window); otherwise start_time/end_time default to the latest 30 days. platforms, statuses, and supplier_platform_id are optional filters; copy supplier_platform_id from list_stores. Paginate with page_number.
[Side effects] None; read-only, never creates or modifies any record.
[Confirmation] No confirmation required; this tool is read-only and never creates or modifies any record.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_order_paymentlink_and_billing"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end_time | No | Optional Unix end timestamp. When billing_id is omitted and both time fields are omitted, defaults to now. | |
| statuses | No | Optional billing statuses. Omit to search all statuses. Paste JSON example: ["paid"]. | |
| page_size | No | Items per page, up to 100. | |
| platforms | No | Optional billing platforms. Omit to search all platforms. Paste JSON example: ["dsers"]. | |
| billing_id | No | Optional exact Order Billing ID as a decimal string. When set, the Tool does not inject a default time window. The lookup still searches only order checkout billings. | |
| start_time | No | Optional Unix start timestamp. Ignored as a default window when billing_id is set. When billing_id is omitted and both time fields are omitted, defaults to 30 days before end_time. | |
| page_number | No | 1-based page number. | |
| supplier_platform_id | No | Optional supplier platform ID as a decimal string. Copy from list_stores supplier_apps[].supplier_platform_id; never use applications[].sales_channel_id. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | Billing records for this page | |
| pagination | Yes | page_number pagination | |
| toolcall_response_at | Yes | UTC timestamp when the Tool response was returned, formatted as RFC3339. |