商户入账结果确认

• Endpoint: POST /aggregate-pay/api/gateway/orderConfirm
• Tags: 收单/账单支付

Description

商户收到支付通知且进行内部入账处理后，返回给PayerMax最终的入账结果；如果是返回入账成功，则PayerMax将该笔计入清分账户并进行结算。

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.0
keyVersion	string	Yes	maxLength: 8	密钥版本 当前值为：1
requestTime	string	Yes	maxLength: 32	请求时间，符合rfc3339规范，格式：yyyy-MM-dd'T'HH:mm:ss.SSSXXX 时间需要在当前时间两分钟内
merchantNo	string	No	maxLength: 32	商户号，商户与PayerMax业务签约时生成的唯一标识
merchantAppId	string	Yes	maxLength: 64	商户应用Id，PayerMax分配给商户应用的唯一标识
data	object	Yes
data.tradeToken	string	Yes	maxLength: 64	PayerMax订单号。
data.referenceNo	string	Yes	maxLength: 64	商户的还款合同号，其中前五位由PayerMax生成。
data.amount	number	Yes		订单金额。
data.currency	string	Yes	maxLength: 3	订单币种。
data.confirmation	string	Yes	maxLength: 16	商户入账确认结果，"Y"或"N"
data.failureReason	string	Yes	maxLength: 255	商户入账确认失败原因。注：confirmation为"N"时，该字段为必填。

Example

{
  "version": "1.0",
  "keyVersion": "1",
  "requestTime": "2024-02-26T13:40:36.706Z",
  "merchantAppId": "bbd8d2639a7c4dfd8df7d00529123456",
  "merchantNo": "020110987531234",
  "data": {
    "referenceNo": "TEST100001",
    "tradeToken": "T20240131032780256123456",
    "amount": 40.85,
    "currency": "PHP",
    "confirmation": "Y",
    "failureReason": ""
  }
}

Responses

200

Field	Type	Required	Constraints	Description	Enum
code	string	Yes		返回码，’APPLY_SUCCESS’代表成功
msg	string	Yes		返回描述，’Success.’
data	object	No		响应data。
data.referenceNo	string	Yes	maxLength: 64	商户的还款合同号，其中前五位由PayerMax生成。
data.tradeToken	string	Yes	maxLength: 64	PayerMax订单号。

Response Example

{
  "code": "APPLY_SUCCESS",
  "msg": "Success.",
  "data": {
    "referenceNo": "PM00100001",
    "tradeToken": "T20240131032780256487268"
  }
}