Submit trxId (/payin/trxId/submit)

Description

Merchants can call this endpoint to submit a customer-provided mobile wallet transaction ID (trxId) and associate it with a specific merchant order (merchantOrderNo).

---

Request Information

• Endpoint: /payin/trxId/submit
• Method: POST
• Content-Type: application/json; charset=utf-8

---

HTTP Headers

Header	Required	Type	Description
merchantNo	Yes	String	Merchant ID
sign	Yes	String	Base64-encoded RSA digital signature of the request body

---

Request Body Parameters

Parameter	Required	Type	Example	Description
timestamp	Yes	Long	1772880250000	Epoch timestamp in milliseconds
trxId	Yes	String	SDIIFKISDL	trxId (Unique transaction ID generated by the wallet)
merchantOrderNo	Yes	String	202603070001	Merchant order number

Request Payload Example

{
  "timestamp": 1772880250000,
  "trxId": "SDIIFKISDL",
  "merchantOrderNo": "202603070001"
}

---

Response Parameters

1. Success Response Example

{
  "code": 1,
  "msg": "success",
  "data": {}
}

2. Order Already Finished Response Example

{
  "code": 0,
  "msg": "ORDER_FINISH",
  "data": {}
}

3. trxId Already Used Response Example

{
  "code": 0,
  "msg": "TRXID_IS_USED",
  "data": {}
}

4. trxId Not Found Response Example

{
  "code": 0,
  "msg": "TRXID_NOT_EXIST"
}

5. Other Error Response Example

{
  "code": 0,
  "msg": "ERROR_CODE"
}

---

Response Fields Description

Field	Required	Type	Description
code	Yes	String / Integer	Status code: 1 for success, 0 for failure
msg	Yes	String	Message description (success, ORDER_FINISH, TRXID_IS_USED, TRXID_NOT_EXIST, or error code)
data	Yes	Object	Response data payload (empty object {} when no payload)
data.merchantNo	Yes	String	Merchant ID
data.merchantOrderNo	Yes	String	Merchant order number
data.platOrderNo	Yes	String	Platform order number
data.amount	Yes	String	Transaction amount
data.fee	Yes	String	Processing fee
data.expireTime	Yes	String	Order expiration time
data.payUrl	Yes	String	Checkout payment URL (payUrl)
data.status	Yes	String	Status: 0 Created, 1 Expired, 2 Failed, 3 Succeeded
data.payAccountNo	No	String	Payer wallet account number
data.trxId	No	String	Unique transaction ID generated by the e-wallet system to identify this transaction