付款查询

• Endpoint: POST /v2/delSuffixStart11
• Tags: 出款

Description

此接口为API付款查询接口，该接口返回参数请注意以下事项，否则可能会有资损风险：

1. 当"bizCode": "0000"且返回status，代表查询成功，订单状态请status为准；
2. 当"bizCode": "4000"且"message": "The queried transaction does not exist"， 间隔（5min）查询多次后返回一样，可不换orderId重新下单；
3. 其他场景请检查参数后，可重新请求；

Parameters

Field	In	Type	Required	Constraints	Description
sign	header	string	Yes

Parameter Examples

• sign: "FPFVT3o227JrFRbqu19boZCpVVTF9KznxyRawUmxpfXilHV/0yK46haPhAjNu1hPUMy7Vw/ILXhfzffNm4Fj0apWknlTY9OJxnSoQxS9BTFtc61tn5yV1q69x/kkBl82/qwg+XTJ4fOzy7Mar3VaC1E2PlDA6RkkKBUyNE6RYgsdB+Su7an4+4HVTNAnoe74WyvBgxTLMNg28igBTdqxaO3w/UBY6ObVp7vkqkQGdL1Y+HgmMYaAVwrM3+ALWGId0sJ+YqTY4WJ+0xCRGhaSnybiIjZsQEYyID68WNUfuavDLDsEhaMm/HfQvf5p0R1Ltovp3wwJnEbQcjY458iX5A=="

Request Body

Content-Type: application/json

Field	Type	Required	Constraints	Description	Enum
bizType	string	Yes	maxLength: 32	接口业务代码，此处需传入“paymentTransQry”
merchantId	string	Yes	maxLength: 32	商户订单号，与PayerMax平台订单号（tradeNo）两者至少设置一个，商户订单号优先被作为查询条件
orderId	string	No	maxLength: 63	商户订单号
tradeNo	string	No	maxLength: 64	PayerMax平台订单号，与商户订单号（orderId）两者至少设置一个，商户订单号优先被作为查询条件
version	string	No	maxLength: 5	接口版本

Example

{
  "bizType": "paymentTransQry",
  "merchantId": "SP12345678",
  "orderId": "WD12324345346",
  "tradeNo": "20230428081551DO1234524600475529002",
  "version": "2.0"
}

Responses

200

Field	Type	Required	Constraints	Description	Enum
bizCode	string	Yes	maxLength: 6	接口响应码，仅代表接口调用的结果。 交易的状态请以回调接口及查询接口中的status 为准。
message	string	Yes	maxLength: 256	接口响应描述
data	object	Yes		具体返回数据，注意：data字段在bizCode为0000的时候有返回
data.debit	string	Yes	maxLength: 512	付款方信息（商户）
data.destination	string	Yes	maxLength: 512	收款方信息（用户）
data.source	string	Yes	maxLength: 512	交易信息
data.orderId	string	No	maxLength: 63	商户订单号
data.passBackParams	string	No	maxLength: 512	商户透传数据，原样返回
data.payFinishTime	number	No		该笔订单成功、失败的时间，只在订单到达终态时存在
data.bounceBackTime	number	No		该笔订单退票的时间（仅在退票中出现）
data.redeemCode	string	No	maxLength: 32	1.FAWRY取款码，2.运营商充值PIN码
data.expiryTime	number	No		该笔订单可以取款的最晚时间（仅在线下场景中出现）
data.responseCode	string	No	maxLength: 32	查询响应码
data.responseMsg	string	No	maxLength: 256	响应码描述
data.status	number	Yes		付款状态：1-成功，2-失败，3-支付中，4-出款退票
data.subStatus	string	No		交易子状态, 当订单交易状态为PENDING时，PayerMax将提供子状态，展示交易处理进度，具体枚举值请参考：【交易子状态介绍】。未返回可联系技术支持升级。
data.tradeNo	string	No		PayerMax平台订单号
data.transactionUtcTime	number	Yes		交易UTC时间
data.additionalIdentifier	string	No		交易附加信息，需要将回调版本升级为4.0，才有该字段，如有需求，可以联系PayerMax技术支持进行调整
data.fundsFreezeTime	string	No		资金动账时间，符合rfc3339规范，格式：yyyy-MM-dd'T'HH:mm:ss Z，需要将回调版本升级为3.0，才有该字段，如有需求，可以联系PayerMax技术支持进行调整
data.fundsReturnTime	string	No		资金返还时间，符合rfc3339规范，格式：yyyy-MM-dd'T'HH:mm:ss Z，需要将回调版本升级为3.0，才有该字段，如有需求，可以联系PayerMax技术支持进行调整

Response Example: 1

成功示例

{
  "bizCode": "0000",
  "data": {
    "debit": "{\"amount\":\"14551.00\",\"currency\":\"IDR\",\"exchangeRate\":\"14551.3328650147\",\"fee\":\"0.00\",\"feeCurrency\":\"USD\",\"tax\":\"0.00\",\"taxCurrency\":\"USD\"}",
    "destination": "{\"amount\":\"14551.00\",\"currency\":\"IDR\",\"exchangeRate\":\"14551.3328650147\",\"fee\":\"0.00\",\"feeCurrency\":\"IDR\",\"tax\":\"0.00\",\"taxCurrency\":\"IDR\"}",
    "orderId": "dev_1639483955",
    "passBackParams": "this is passBackParams",
    "payFinishTime": 1639483970000,
    "source": "{\"amount\":\"1.00\",\"currency\":\"USD\"}",
    "status": 1,
    "fundsFreezeTime": "2024-04-17T06:35:09 +0000",
    "fundsReturnTime": "2024-04-18T07:13:01 +0000",
    "tradeNo": "WD20211214121226853360448",
    "transactionUtcTime": 1639483946000,
    "additionalIdentifier": "{\"referenceId\":\"2024041710121481030100166528590615003\"}"
  },
  "message": "success"
}

Response Example: 2

异常示例

{
  "msg": "System is busy, please try again later.",
  "code": "SYSTEM_ERROR"
}