交易状态/错误码

1. 交易状态

当Payermax受理您的下单请求后，通过查询API或通知均可感知到付款状态。您可以通过获取交易状态，从而制定业务流程。 具体交易状态可参考：【交易状态】。

2. 错误码

Payermax对外API提供了稳定的服务，若出现异常则会在http接口响应的body中告知您错误信息，例如：

{
	"msg": "The amount doesn't match the payment method requirement.",
	"code": "AMOUNT_LIMIT"
}

同样，在异步的回调中，也会响应失败信息，例如：

{
	"msg": "Payment was not completed on time.",
	"code": "PAYMENT_FAILED",
	"data": {
		"reference": "JOLLY",
		"country": "TH",
		"totalAmount": 300,
		"outTradeNo": "TP002024051309261650130939",
		"currency": "THB",
		"tradeToken": "T2024051309124735760727",
		"paymentDetails": [],
		"status": "CLOSED"
	},
	"keyVersion": "1",
	"appId": "5a48dcf440074021b87d4ef901bf9629",
	"merchantNo": "SP18440851",
	"notifyTime": "2024-05-13T10:28:03.606Z",
	"notifyType": "PAYMENT"
}

若正常受理，返回code是“APPLY_SUCCESS”。

接口返回的错误码列表可参考：【错误码列表】。