TrxID Submit

After an H2H collection payment is completed, submit the user transaction ID generated on the wallet side.

POST/api/v2/pay/trxid/submit

Used to submit the user's transaction ID after order creation so the platform can continue processing and determine the result.

Usage Notes

• In H2H mode, you usually create the order first through the collection API and then call this API to submit the user's transaction ID.
• After the user completes the payment, collect and submit trxId from the cashier page or your merchant-side flow.

TIP

Use the code field to judge the acceptance result:

• code = 00000: Submission succeeded. Wait for the callback or query API for the final result.
• Any other code value: The request was not accepted successfully. Handle it according to the error reason.

Request Headers

x-access-keystringRequired

Merchant access identifier

signaturestringRequired

Request signature

Request Parameters

timestampstringRequired

Millisecond timestamp string, for example: 1715941383720

platformOrderNostringRequired

Unique platform order number

trxIdstringRequired

User transaction ID

Response Parameters

messagestringReturned

Request result. Returning success only means the request was accepted and should not be used for merchant business logic

codestringReturned

Business status code. 00000 means the request was accepted. Other 5-digit values indicate specific error reasons; refer to the error code page

timestampstringReturned

Transaction time

successbooleanReturned

API call result

databooleanReturned

Submission result. true means the transaction ID was submitted successfully

Failure Example

{
  "message": "Transaction not found",
  "code": "40401",
  "timestamp": 1728609277476,
  "success": false,
  "data": null
}