支付确认

• Endpoint: POST /aggregate-pay/api/gateway/confirmPayment
• Tags: 收单

Description

支付确认接口

Parameters

Field	In	Type	Required	Constraints	Description
Content-Type	header	string	Yes
sign	header	string	Yes		签名信息请参考技术文档

Parameter Examples

• Content-Type: "application/json"
• 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
version	string	Yes	maxLength: 8	接口版本 当前值为：1.5
keyVersion	string	Yes	maxLength: 8	密钥版本 当前值为：1
requestTime	string	Yes	maxLength: 32	请求时间，符合rfc3339规范，格式：yyyy-MM-dd'T'HH:mm:ss.SSSXXX 时间需要在当前时间两分钟内
appId	string	Yes	maxLength: 64	商户应用Id，PayerMax分配给商户应用的唯一标识
merchantNo	string	No	maxLength: 32	商户号，商户与PayerMax业务签约时生成的唯一标识
data	object	No		请求数据体
data.outTradeNo	string	Yes	maxLength: 64	原商户订单号
data.tradeToken	string	No	maxLength: 64	正向交易单的交易Token
data.paymentDetail	object	No		退款回调地址，可后台配置【配置地址】
data.paymentDetail.verificationCode	string (char)	Yes	maxLength: 32, minLength: 1, pattern: ^[A-Za-z0-9]+$

Example

{
  "version": "1.5",
  "keyVersion": "1",
  "requestTime": "2023-08-22T12:40:06.840Z",
  "appId": "a0dddd1f622243cb9aa1b676e808b5f8",
  "merchantNo": "02021382719993",
  "data": {
    "outTradeNo": "APIFOXDEV1759988765500077",
    "tradeToken": "T2025072902513478000003",
    "paymentDetail": {
      "verificationCode": "99888"
    }
  }
}

Responses

200

Field	Type	Required	Constraints	Description	Enum
code	string	Yes		返回码，’APPLY_SUCCESS’代表成功。只代表接口请求成功，不代表订单状态。
msg	string	Yes		返回描述，’Success.’。只代表接口请求成功，不代表订单状态。
data	object	Yes
data.outRefundNo	string	Yes	maxLength: 64	商户退款申请号
data.tradeOrderNo	string	Yes	maxLength: 64	交易订单号
data.refundTradeNo	string	Yes	maxLength: 64	PayerMax退款流水号
data.status	string	Yes	maxLength: 32	退款状态：REFUND_PENDING，REFUND_FAILED

Response Example

{
  "code": "APPLY_SUCCESS",
  "msg": "",
  "data": {
    "outRefundNo": "R1642411016202",
    "tradeOrderNo": "20220117091121TI366100056090",
    "refundTradeNo": "20220117091657TI790000055087",
    "status": "REFUND_PENDING"
  }
}