Skip to content

支付链接更新回调

  • Endpoint: POST /payLinkResultNotifyUrl
  • Tags: 收单/链接支付

Description

链接被支付成功时,回调链接详情。 提示:该地址无需商户主动请求,以下request.body为payermax对订单状态的回调内容,商户收到回调后需要响应

Parameters

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

Request Body

FieldTypeRequiredDescriptionEnum
codestringYes返回码,’APPLY_SUCCESS’代表成功
msgstringYes返回描述,’Success.’
keyVersionstringYes密钥版本。当前值为:1
appIdstringYes商户应用Id,PayerMax分配给商户应用的唯一标识
merchantNostringYes商户号,商户与PayerMax业务签约时生成的唯一标识
notifyTimestringYes通知时间,符合rfc3339规范,格式:yyyy-MM-dd’T’HH:mm:ss.SSSXXX
notifyTypestringYes通知类型 PAYBYLINK
dataobjectNo返回数据体
data.linkIdstringYesPMmax链接唯一单号
data.merchantLinkIdstringYes商户链接唯一订单号
data.linkUrlstringYesPayByLink url
data.qrCodeUrlstringYesPayByLink QRcode url
data.linkStatusstringYesACTIVE、EXPIRED
data.totalAmountstringYes商户传入的订单金额,金额的单位为元。 除以下国家外,按照各国币种支持的小数点位上送 注意:巴林、科威特、约旦、阿曼、突尼斯,本币只支持两位小数; 印尼、中国台湾、韩国、越南、智利、巴基斯坦、哥伦比亚、日本、冰岛、巴拉圭,本币不支持带小数金额。
data.countrystringYes国家代码,大写字母,如果所传的国家代码与币种不匹配,则以货币代码对应的地区展示收银台。如指定了支付方式,则国家必须上送,参见【交易支持国家/地区与币种
data.currencystringYes币种代码,大写字母,参见【交易支持国家/地区与币种
data.expiresAtstringYes链接具体失效时间
data.linkDescriptionstringYes链接描述,不展示给用户,用于商户备注
data.payByLinkInfoarray[object]Yes链接单的交易详情结构体,只会返回成功的支付详情。
data.payByLinkInfo[].outTradeNostringNo每笔交易订单的唯一标识,当链接没有被打开时,该字段为空
data.payByLinkInfo[].statusstringYes交易状态:SUCCESS、PENDING、CLOSESUCCESS, PENDING, CLOSE
data.payByLinkInfo[].completeAtstringNo交易成功时间,仅当交易状态为成功时,返回该时间
data.payByLinkInfo[].paymentDetailsarray[object]No支付方式信息,只有交易成功会返回支付方式
data.payByLinkInfo[].paymentDetails[].targetOrgstringNo目标机构,用户支付所选择的目标机构,只有交易成功才会返回用户支付所选择的目标机构
data.payByLinkInfo[].paymentDetails[].paymentMethodTypestringNo支付方式类型,用户支付选择的支付方式,只有交易成功才会返回用户支付所选择的支付方式
data.payByLinkInfo[].paymentDetails[].cardInfoobjectNo卡信息
data.payByLinkInfo[].paymentDetails[].cardInfo.cardOrgstringNo卡组织,当paymentMethodType为CARD时返回,只有交易成功且用户选择卡组织支付时才返回
data.payByLinkInfo[].paymentDetails[].cardInfo.countrystringNo发卡国家
data.payByLinkInfo[].paymentDetails[].cardInfo.cardTypestringNo卡类型,DEBIT、CREDIT等。
data.payByLinkInfo[].paymentDetails[].cardInfo.totalCardOrgarray[string]No卡的所有卡组织,双标卡会返回两个。
data.payByLinkInfo[].paymentDetails[].cardInfo.typestringNo卡性质。PAN为真实卡;NETWORK_TOKEN为虚拟卡,如APPLEPAY。
data.payByLinkInfo[].paymentDetails[].cardInfo.sourcestringNo卡信息来源。CARD、APPLEPAYGOOGLEPAY_PANGOOGLEPAY_CRYPTOGRAMNETWORK_TOKEN
data.payByLinkInfo[].paymentDetails[].cardInfo.cardBinNostringNo卡bin号。
data.payByLinkInfo[].paymentDetails[].cardInfo.cardNumberstringNo卡号,掩码返回。
data.payByLinkInfo[].paymentDetails[].cardInfo.cardHolderNamestringNo持卡人姓名,掩码返回。
data.payByLinkInfo[].paymentDetails[].cardInfo.cardLast4stringNo真实卡号后四位。
data.payByLinkInfo[].paymentDetails[].cardInfo.cardExpirationYearstringNo卡有效年。
data.payByLinkInfo[].paymentDetails[].cardInfo.cardExpirationMonthstringNo卡有效月。
data.payByLinkInfo[].paymentDetails[].cardInfo.cardIdentifierNostringNo卡号,当paymentMethodType为CARD时掩码返回

Responses

200

FieldTypeRequiredDescription
codestringYes返回码,’ SUCCESS’代表成功
msgstringYes返回描述,’Success.’

Enum Reference

data.payByLinkInfo[].status

  • SUCCESS
  • PENDING
  • CLOSE

此页面的内容有帮助吗?

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

Last updated:

Released under the MIT License.