Order: Start Payment Flow
create_order_payment_link[Order]
[What it does] Generates authenticated DSers Checkout links for awaiting-payment orders. A successful call returns only aggregate checkout_urls and message; AliExpress and Alibaba.com also return dsers_order_ids. It never charges the user or completes payment.
[When to use] Use it when the user wants to pay specific awaiting-payment orders, and when the agent needs to hand the user a payment entry point for orders already in that state. Trigger words: pay these orders, create a payment link, settle this batch.
[When not to use] To find awaiting-payment orders, use list_orders. To place orders with suppliers, use place_orders_to_suppliers. It cannot pay on the user's behalf.
[How to use]
supplier_platform_idandselection_modeare required. Selected mode needs exact order IDs, up to 100; filtered mode covers every order matching the filters, which is usually far broader than the user expects, so confirm the scope first.AliExpress and Alibaba.com merge selected or filtered matches into one direct checkout URL and return those
dsers_order_ids. Filtered mode is capped at 100 matching orders; more than 100 is rejected.The non-AliExpress path creates a persistent payment-link record and is not idempotent, so never recreate an uncertain link; verify through the order list or the Payment Link page instead.
The response does not return amounts, currencies, or per-group statuses. For non-AliExpress suppliers,
checkout_urlscontains only definitely created links andmessagereports whether every supplier group produced a link or the result is partial. If no link is definitely confirmed, the Tool returns a structured error. Never infer omitted group outcomes or automatically retry.Read current order data before confirmation to show the exact order scope and any available amounts or currencies. The user has to open the link to pay, and payment status must be confirmed later from the order data. [Side effects] No charge; non-AliExpress groups create payment-link records. [Confirmation] Required but skippable; before calling, show the order scope and any available amounts from current order data.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"selection_mode": "<selection_mode>",
"supplier_platform_id": "<supplier_platform_id>"
},
"name": "create_order_payment_link"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| flags | No | Optional DSers order color flags. Paste JSON example: ["red"]. | |
| query | No | Optional order-table search value used in filtered mode. Required when search_by is not default. | |
| end_time | No | Optional seller-order creation end time as a Unix timestamp for filtered mode. | |
| place_by | No | Optional existing supplier-order placement-source filter. | any |
| countries | No | Optional destination country codes for filtered mode. This is the only country filter. Paste JSON example: ["US"]. | |
| search_by | No | How query is interpreted in filtered mode. | default |
| agency_ids | No | Optional agency IDs as decimal strings. Paste JSON example: ["100071"]. | |
| start_time | No | Optional seller-order creation start time as a Unix timestamp for filtered mode. | |
| selection_mode | Yes | selected uses the explicit dsers_order_ids array; filtered matches awaiting-payment orders by dsers_store_ids, query, search_by, start_time, end_time, countries, flags, agency_ids, and place_by. AliExpress and Alibaba.com accept both modes and merge matches into one checkout URL; filtered fails if more than 100 orders match. | |
| dsers_order_ids | No | Exact DSers order IDs. Copy from list_orders results. Required for selected mode; omit in filtered mode. For AliExpress and Alibaba.com, selected and filtered matches are combined into one direct checkout URL. Paste JSON example: ["2088507008557908224"]. | |
| dsers_store_ids | No | Optional DSers store IDs included in filtered mode. Paste JSON example: ["1999323491106619392"]. | |
| supplier_platform_id | Yes | Supplier platform represented by the current DSers Orders tab. Copy from list_stores supplier_apps[].supplier_platform_id or list_orders; never guess it. Required for both modes, and every selected order is revalidated against it. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| message | Yes | Required next step; this Tool did not charge the user | |
| checkout_urls | Yes | DSers Checkout URLs ready for the authenticated user to open | |
| dsers_order_ids | No | DSers order IDs included in the AliExpress or Alibaba.com checkout URL | |
| toolcall_response_at | Yes | UTC timestamp when the Tool response was returned, formatted as RFC3339. |