Skip to content

收款结果异步通知

  • Endpoint: POST /delSuffixStart8
  • Tags: 收款

Parameters

FieldInTypeRequiredConstraintsDescription
signheaderstringYes

Parameter Examples

  • sign: "FPFVT3o227JrFRbqu19boZCpVVTF9KznxyRawUmxpfXilHV/0yK46haPhAjNu1hPUMy7Vw/ILXhfzffNm4Fj0apWknlTY9OJxnSoQxS9BTFtc61tn5yV1q69x/kkBl82/qwg+XTJ4fOzy7Mar3VaC1E2PlDA6RkkKBUyNE6RYgsdB+Su7an4+4HVTNAnoe74WyvBgxTLMNg28igBTdqxaO3w/UBY6ObVp7vkqkQGdL1Y+HgmMYaAVwrM3+ALWGId0sJ+YqTY4WJ+0xCRGhaSnybiIjZsQEYyID68WNUfuavDLDsEhaMm/HfQvf5p0R1Ltovp3wwJnEbQcjY458iX5A=="

Request Body

Content-Type: application/json

FieldTypeRequiredConstraintsDescriptionEnum
merchantIdstringYesPayerMax 分配给商户的唯一标识
tradeOrderNostringYesPayerMax平台订单号
orderIdstringYes商户订单号
statusnumberYes1代表成功;2代表失败
countryCodestringNo国家代码,当商户上传countryCode时返回,参见【支持的国家与币种
totalAmountstringYes商户传入的交易金额
currencystringYes商户传入的交易币种,在美金收单场景中为美金
paymentTypestringYes实际支付方式编码,当订单成功时返回,参见【各国收款方式列表】备注:如果需要返回该字段,可以反馈payermax技术支持升级回调版本
payAmountstringYes为用户实际支付的支付金额
payCurrencystringYes为用户实际支付的币种
exchangeRatestringNo交易金额转换为支付金额使用的汇率 当交易币种与支付币种非同币种时返回
errorCodestringYes支付失败时对应的错误码值,若支付成功为空字符串
errorMsgstringYes支付失败时对应的错误描述,若支付成功为空字符串
referencestringNo商户传入的参数,和请求参数中的reference完全一致
cardInfoobjectNo卡信息
cardInfo.cardOrgstringNo卡组
cardInfo.cardIdentifierNostringNo卡号(掩码返回) 备注:如需返回该字段,可反馈payermax技术支持升级回调版本
cardInfo.cardIdentifierNamestringNo卡姓名(掩码返回) 备注:如需返回该字段,可反馈payermax技术支持升级回调版本
paymentMethodTypestringNomaxLength: 16支付方式
targetOrgstringNomaxLength: 16目标机构
channelNostringNomaxLength: 64渠道订单号
thirdChannelNostringNomaxLength: 64三方单号
paymentCodestringNomaxLength: 64VA单号
orderTypestringYes订单类型,默认为PAYMENT,重复支付时为DUPLICATE_PAYMENT
originalOrderIdstringNoorderType为DUPLICATE_PAYMENT时,该值为重复支付所关联的原商户订单号,否则为空
originalTradeOrderNostringNoorderType为DUPLICATE_PAYMENT时,该值为重复支付所关联的原PayerMax平台订单号,否则为空

Example

json
{
  "orderId": "21230412340979178110000805",
  "tradeOrderNo": "TOKEN202304111948856115",
  "errorCode": "",
  "errorMsg": "",
  "paymentType": "A34",
  "reference": "GM666814221071401199#20230412340979178100000805",
  "totalAmount": "33.50",
  "payAmount": "33.50",
  "merchantId": "SP35661109",
  "exchangeRate": "1",
  "countryCode": "ID",
  "payCurrency": "IDR",
  "currency": "IDR",
  "channelNo": "DMCP000000000177005",
  "thirdChannelNo": "4ikqJ6ktEqyRawE1dvqb9c",
  "paymentCode": "2312121212",
  "status": 1,
  "paymentMethodType": "CARD",
  "cardInfo": {
    "cardOrg": "MASTERCARD",
    "cardIdentifierNo": "520000******0007",
    "cardIdentifierName": "*D"
  },
  "targetOrg": "",
  "orderType": "PAYMENT",
  "originalOrderId": "",
  "originalTradeOrderNo": ""
}

Responses

200

FieldTypeRequiredConstraintsDescriptionEnum
bizCodestringYesmaxLength: 6结果码,仅可回传0000。‘0000’此值仅代表收到通知,不代表订单状态
messagestringNomaxLength: 32结果描述,success

Response Example

json
{
  "bizCode": "0000",
  "message": "success"
}

此页面的内容有帮助吗?

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

Released under the MIT License.