Skip to content

付款结果通知

  • Endpoint: POST /disbursementResultNotifyUrl
  • Tags: 付款

Description

该地址无需商户主动请求,以下request.body为payermax对订单状态的回调内容,您在收到回调后需要响应

Parameters

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

Request Body

FieldTypeRequiredDescription
codestringYes回调通知码,APPLY_SUCCESS代表有效回调
msgstringYes回调通知码描述,Success.
keyVersionstringYes密钥版本,当前版本1
appIdstringYes商户应用Id,PayerMax分配给商户应用的唯一标识
merchantNostringYes商户号,商户与PayerMax业务签约时生成的唯一标识
notifyTimestringYes通知时间,符合rfc3339规范,格式:yyyy-MM-dd'T'HH:mm:ss.SSSXXX
notifyTypestringYes通知类型 PAYOUT
dataobjectYes数据体
data.outTradeNostringYes商户订单号
data.tradeNostringYesPayerMax交易流水号
data.transactionUtcTimestringYes交易创建时间,符合rfc3339规范,格式:yyyy-MM-dd'T'HH:mm:ss Z
data.fundsFreezeTimestringNo资金动账时间,符合rfc3339规范,格式:yyyy-MM-dd'T'HH:mm:ss Z
data.fundsReturnTimestringNo资金返还时间,符合rfc3339规范,格式:yyyy-MM-dd'T'HH:mm:ss Z
data.payFinishTimestringNo交易完成时间,符合rfc3339规范,格式:yyyy-MM-dd'T'HH:mm:ss Z
data.bounceBackTimestringNo退票时间,符合rfc3339规范,格式:yyyy-MM-dd'T'HH:mm:ss Z
data.redeemCodestringNo1.FAWRY取款码,2.运营商充值PIN码
data.expiryTimestringNo订单过期时间,符合rfc3339规范,格式:yyyy-MM-dd'T'HH:mm:ss Z
data.statusstringYes交易状态,SUCCESS成功, FAILED失败 ,PENDING进行中,BOUNCEBACK退票
data.subStatusstringNo交易子状态, 当订单交易状态为PENDING时,PayerMax将提供子状态,展示交易处理进度,具体枚举值请参考:【交易子状态介绍】。未返回可联系技术支持升级。
data.tradeobjectYes交易信息
data.trade.amountstringYes商户在请求中传入的交易金额,单位元
data.trade.currencystringYes商户在请求中传入的交易金额对应货币代码
data.sourceobjectYes付款信息(商户)
data.source.amountstringYes付款方-扣款金额
data.source.currencystringYes付款方-扣款币种
data.source.exchangeRatestringNo交易币种转换为扣款币种的汇率
data.source.feestringNo付款方-手续费
data.source.feeCurrencystringNo付款方-手续费币种
data.source.taxstringNo付款方-税费
data.source.taxCurrencystringNo付款方-税费币种
data.destinationobjectYes收款信息(用户)
data.destination.amountstringYes收款方-到账金额
data.destination.currencystringYes收款方-到账币种
data.destination.exchangeRatestringNo交易款币种转换为到账币种的汇率
data.destination.feestringNo收款方-手续费
data.destination.feeCurrencystringNo收款方-手续费币种
data.destination.taxstringNo收款方-税费
data.destination.taxCurrencystringNo收款方-税费币种
data.referencestringNo附加数据,商户上送的值
data.notifyPhone stringNo收款方通知邮件手机号
data.notifyEmailstringNo收款方通知邮件地址
data.responseCodestringNo订单失败错误码,详见【错误码
data.responseMsgstringNo订单失败错误码描述
data.additionalIdentifierobjectNo交易附加信息,出款回调升级到3.0版本以上,才会返回该字段。如有需求,可以联系PayerMax技术支持进行调整
data.additionalIdentifier.referenceIdstringNo收款银行/机构的交易单号(依据历史经验,目前仅沙特BankTransfer返回的该单号可以作为凭证跟收款行确认是否到账,交易单号格式如:20240418SAARNBARNB1B44410558522170)

Responses

200

FieldTypeRequiredDescription
msgstringYes响应 ‘Success’(仅代表成功收到通知,不代表订单状态)
codestringYes仅可响应 ‘SUCCESS’(仅代表成功收到通知,不代表订单状态)

此页面的内容有帮助吗?

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

Last updated:

Released under the MIT License.