Skip to content

支付成功通知商户

  • Endpoint: POST /collectResultNotifyUrlForBillPayment
  • Tags: 收单/账单支付

Description

对客扣款成功后,PayerMax会自动入账并将调用该接口通知商户入账结果,商户可仅响应code和msg,无需响应data。

注:如商户希望PayerMax先不处理入账,可联系PayerMax进行相应配置。配置完成后,PayerMax 会根据商户的入账结果进行处理,方式有如下两种:

  • 商户可同步响应入账结果,即接收到该通知后,可将入账确认结果响应到data中。
  • 商户可异步通知PayerMax入账结果,即调用PayerMax提供的商户入账结果确认接口。

Parameters

FieldTypeRequiredDescription
Content-Type (header)stringYes
sign (header)stringYes签名信息请参考技术文档

Request Body

FieldTypeRequiredDescription
codestringYes返回码
msgstringYes返回描述
keyVersionstringYes密钥版本。当前值为:1
merchantAppIdstringYes商户应用Id,PayerMax分配给商户应用的唯一标识
merchantNostringYes商户号,商户与PayerMax业务签约时生成的唯一标识
notifyTimestringYes通知时间,符合rfc3339规范,格式:yyyy-MM-dd'T'HH:mm:ss.SSSXXX
notifyTypestringYes通知类型REPAYMENT_RECEIPT
dataobjectYes
data.tradeTokenstringYesPayerMax订单号。
data.outTradeNostringYes订单号。注:该单号由PayerMax生成。
data.referenceNostringYes商户的还款合同号,其中前五位由PayerMax生成。
data.payStatusstringYes支付状态. PAY_SUCCESS
data.totalAmountnumberYes订单金额。
data.currencystringYes订单币种。
data.completeTimestringYes用户真实付款的时间。
data.paymentSucceedTimestringNo支付完成时间。
data.payerMobileNumberstringYes付款人手机号。
data.payerEmailstringNo付款人邮箱。
data.paymentDetailsarray[object]Yes支付详情。
data.paymentDetails[].paymentMethodTypestringYes用户选择的支付方式。
data.paymentDetails[].targetOrgstringYes用户选择的目标机构。

Responses

200

FieldTypeRequiredDescription
codestringYes返回码,’SUCCESS’代表成功
msgstringYes返回描述,’Success’
dataobjectNo响应data。注:本data体可选填,但如果返回了data,data内的各字段类型和必填性描述如下。
data.referenceNostringYes商户的还款合同号,其中前五位由PayerMax生成。
data.tradeTokenstringYesPayerMax订单号。
data.amountnumberYes订单金额
data.currencystringYes订单币种
data.confirmationstringYes商户入账确认的结果。"Y"或"N"。注:为N时PayerMax不会对该笔做结算。
data.failureReasonstringNo商户入账确认失败的原因。注意:confirmation为N时,该值必填。

此页面的内容有帮助吗?

感谢您帮助改进 PayerMax 产品文档!

Last updated:

Released under the MIT License.