Query Merchant Batch Transfer Order
Query a merchant batch transfer order and its sub-order statuses by batch_id or merchant_batch_no.
Overview
This page documents thePOST /v1/pay/batch/transfer/query endpoint, which queries a merchant batch transfer order and its sub-order statuses. The full request schema, response structure, and examples are rendered from the linked OpenAPI definition above.
Notes
- Authentication uses the standard GatePay signed headers.
- This endpoint is grouped under
Payout→Reward Distribution. X-GatePay-On-Behalf-Ofis optional for this endpoint. Pass it only when you need to specify the initiating account context in an institution-delegated scenario.- For shared signing rules, see /api-reference/version/100/en/common/securityAndSignature.
Headers
The clientId assigned when the merchant registers an application in the Gate merchant console.
"4186d0c6-6a35-55a9-8dc6-5312769dbff8"
Request signature. GatePay uses this signature to verify whether the request is valid.
Millisecond timestamp; the difference from server time must not exceed 30 seconds.
"1672905655498"
Random string. Must comply with HTTP header rules; recommended length is within 32 characters, composed of digits and letters.
"9578"
Optional delegated-subject header. Pass the initiating account ID only when an institution-delegated context needs to be identified; otherwise this header can be omitted.
Body
Request body for querying a merchant batch transfer order.
GatePay batch ID. Either batch_id or merchant_batch_no can be provided. When both are provided, batch_id is used.
Merchant batch number. Either merchant_batch_no or batch_id can be provided. When both are provided, batch_id is used.
Sub-order status filter: ALL, PROCESSING, SUCCESS, FAIL.

