Skip to content

本地银行收款通知

  • Endpoint: POST /vaResultNotifyUrl
  • Tags: 收款

Description

VA收款结果回调

Parameters

FieldInTypeRequiredConstraintsDescription
Content-TypeheaderstringYes
signheaderstringYes签名信息请参考技术文档

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

FieldTypeRequiredConstraintsDescriptionEnum
codestringYesmaxLength: 32返回码,’APPLY_SUCCESS’代表有效通知
msgstringYes有效通知描述:Success
versionstringYes接口版本 当前值为:1.0
keyVersionstringYesmaxLength: 8密钥版本 当前值为:1
appIdstringYesmaxLength: 32商户应用Id,PayerMax分配给商户应用的唯一标识
merchantNostringYesmaxLength: 15商户号,商户与PayerMax业务签约时生成的唯一标识
notifyTimestringYesmaxLength: 32通知时间,符合rfc3339规范,格式:yyyy-MM-dd'T'HH:mm:ss.SSSXXX
notifyTypestringYesmaxLength: 16通知类型,RECEIVE
dataobjectYes数据体
data.requestNostringYesmaxLength: 64PayerMax交易流水号
data.channelTradeNostringYesmaxLength: 64银行单号/外部订单号
data.statusstringYesmaxLength: 16TO_BE_PROVED 需要补交材料;SETTLED 交易成功已入账 REJECTED';交易失败已退回
data.transactionUtcTimestringYesmaxLength: 32交易创建时间,符合rfc3339规范,格式:yyyy-MM-dd’T’HH:mm:ss.SSSXXX
data.completeTimestringYesmaxLength: 32交易完成时间,符合rfc3339规范,格式:yyyy-MM-dd’T’HH:mm:ss.SSSXXX
data.paymentDetailobjectYes支付要素
data.paymentDetail.payeeInfoobjectYes收款方账户信息
data.paymentDetail.payeeInfo.countrystringYesmaxLength: 2收款方账户所属国家
data.paymentDetail.payeeInfo.accountNostringYesmaxLength: 128收款方账号
data.paymentDetail.payeeInfo.accountNickNamestringYesmaxLength: 256收款方昵称
data.paymentDetail.payeeInfo.bankCodestringYesmaxLength: 64银行编码
data.paymentDetail.payerInfoobjectYes付款方账户信息
data.paymentDetail.payerInfo.accountNostringYesmaxLength: 128付款方账号,根据付款方式不同填入相应账号
data.paymentDetail.payerInfo.accountNamestringYesmaxLength: 256付款方全名
data.paymentDetail.payerInfo.bankCodestringYesmaxLength: 64付款方银行CODE
data.paymentDetail.payerInfo.bankNamestringYesmaxLength: 256付款方银行名称
data.paymentDetail.payerInfo.bankBranchstringYesmaxLength: 64付款人银行网点号/分行号
data.paymentDetail.settleobjectYes入账信息
data.paymentDetail.settle.amountstringYes给商户实际入账金额
data.paymentDetail.settle.currencystringYes给商户实际入账金额对应货币代码
data.paymentDetail.settle.feestringYes手续费
data.paymentDetail.settle.feeCurrencystringYes手续费币种
data.paymentDetail.settle.taxstringYes税费
data.paymentDetail.settle.taxCurrencystringYes税费币种
data.paymentDetail.tradeobjectYes交易信息
data.paymentDetail.trade.amountstringYes银行实际到账金额,单位元
data.paymentDetail.trade.currencystringYes银行实际到账金额对应货币代码
data.paymentDetail.remarkstringYesmaxLength: 256附加数据,银行转账备注
data.errorCodestringYesmaxLength: 32订单失败错误码,详见[错误码列表]
data.errorMsgstringYesmaxLength: 256订单失败错误码描述

Example

json
{
  "appId": "67f2c6ef57xxxx20d52e5abfb",
  "code": "APPLY_SUCCESS",
  "data": {
    "channelTradeNo": "1d7111123434043",
    "completeTime": "2024-01-02T10:57:26.805Z",
    "paymentDetail": {
      "payeeInfo": {
        "accountNickName": "DEFAULT",
        "accountNo": "9001xxx017x8",
        "country": "PH"
      },
      "payerInfo": {
        "accountNo": "0231xxxx48x",
        "bankCode": "AUBKPHMMXXX"
      },
      "settle": {
        "amount": "1111.00",
        "currency": "PHP",
        "fee": "20.00",
        "feeCurrency": "PHP",
        "tax": "0.00",
        "taxCurrency": "PHP"
      },
      "trade": {
        "amount": "1131.00",
        "currency": "PHP"
      }
    },
    "requestNo": "2024010xxxx7EO03920002198dd9005",
    "status": "SETTLED",
    "transactionUtcTime": "2024-01-02T03:03:00.466Z"
  },
  "keyVersion": "1",
  "merchantNo": "P010xxx5xxx2222",
  "msg": "Success",
  "notifyTime": "2024-01-02T10:57:26.854Z",
  "notifyType": "RECEIVE",
  "version": "1.0"
}

Responses

200

FieldTypeRequiredConstraintsDescriptionEnum
msgstringYes响应消息
codestringYes响应码

Response Example

json
{
  "msg": "Success",
  "code": "SUCCESS"
}

此页面的内容有帮助吗?

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

Released under the MIT License.