# 交易状态/错误码

### 1. 交易状态

当Payermax受理您的下单请求后，通过查询API或通知均可感知到付款状态。您可以通过获取交易状态，从而制定业务流程。
具体交易状态可参考：[【交易状态】](https://docs.payermax.com/202606-version/appendix/collection/transaction-status.md#_1-交易状态)。

### 2. 错误码

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

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

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

```json
{
	"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”。**

接口返回的错误码列表可参考：[【错误码列表】](https://docs.payermax.com/202606-version/appendix/collection/transaction-status.md#_2-1-错误码列表)。