本地银行收款通知
- Endpoint:
POST /vaResultNotifyUrl - Tags: 收款
Description
VA收款结果回调
Parameters
| Field | In | Type | Required | Constraints | Description |
|---|---|---|---|---|---|
Content-Type | header | string | Yes | ||
sign | header | string | Yes | 签名信息请参考技术文档 |
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
| Field | Type | Required | Constraints | Description | Enum |
|---|---|---|---|---|---|
code | string | Yes | maxLength: 32 | 返回码,’APPLY_SUCCESS’代表有效通知 | |
msg | string | Yes | 有效通知描述:Success | ||
version | string | Yes | 接口版本 当前值为:1.0 | ||
keyVersion | string | Yes | maxLength: 8 | 密钥版本 当前值为:1 | |
appId | string | Yes | maxLength: 32 | 商户应用Id,PayerMax分配给商户应用的唯一标识 | |
merchantNo | string | Yes | maxLength: 15 | 商户号,商户与PayerMax业务签约时生成的唯一标识 | |
notifyTime | string | Yes | maxLength: 32 | 通知时间,符合rfc3339规范,格式:yyyy-MM-dd'T'HH:mm:ss.SSSXXX | |
notifyType | string | Yes | maxLength: 16 | 通知类型,RECEIVE | |
data | object | Yes | 数据体 | ||
data.requestNo | string | Yes | maxLength: 64 | PayerMax交易流水号 | |
data.channelTradeNo | string | Yes | maxLength: 64 | 银行单号/外部订单号 | |
data.status | string | Yes | maxLength: 16 | TO_BE_PROVED 需要补交材料;SETTLED 交易成功已入账 REJECTED';交易失败已退回 | |
data.transactionUtcTime | string | Yes | maxLength: 32 | 交易创建时间,符合rfc3339规范,格式:yyyy-MM-dd’T’HH:mm:ss.SSSXXX | |
data.completeTime | string | Yes | maxLength: 32 | 交易完成时间,符合rfc3339规范,格式:yyyy-MM-dd’T’HH:mm:ss.SSSXXX | |
data.paymentDetail | object | Yes | 支付要素 | ||
data.paymentDetail.payeeInfo | object | Yes | 收款方账户信息 | ||
data.paymentDetail.payeeInfo.country | string | Yes | maxLength: 2 | 收款方账户所属国家 | |
data.paymentDetail.payeeInfo.accountNo | string | Yes | maxLength: 128 | 收款方账号 | |
data.paymentDetail.payeeInfo.accountNickName | string | Yes | maxLength: 256 | 收款方昵称 | |
data.paymentDetail.payeeInfo.bankCode | string | Yes | maxLength: 64 | 银行编码 | |
data.paymentDetail.payerInfo | object | Yes | 付款方账户信息 | ||
data.paymentDetail.payerInfo.accountNo | string | Yes | maxLength: 128 | 付款方账号,根据付款方式不同填入相应账号 | |
data.paymentDetail.payerInfo.accountName | string | Yes | maxLength: 256 | 付款方全名 | |
data.paymentDetail.payerInfo.bankCode | string | Yes | maxLength: 64 | 付款方银行CODE | |
data.paymentDetail.payerInfo.bankName | string | Yes | maxLength: 256 | 付款方银行名称 | |
data.paymentDetail.payerInfo.bankBranch | string | Yes | maxLength: 64 | 付款人银行网点号/分行号 | |
data.paymentDetail.settle | object | Yes | 入账信息 | ||
data.paymentDetail.settle.amount | string | Yes | 给商户实际入账金额 | ||
data.paymentDetail.settle.currency | string | Yes | 给商户实际入账金额对应货币代码 | ||
data.paymentDetail.settle.fee | string | Yes | 手续费 | ||
data.paymentDetail.settle.feeCurrency | string | Yes | 手续费币种 | ||
data.paymentDetail.settle.tax | string | Yes | 税费 | ||
data.paymentDetail.settle.taxCurrency | string | Yes | 税费币种 | ||
data.paymentDetail.trade | object | Yes | 交易信息 | ||
data.paymentDetail.trade.amount | string | Yes | 银行实际到账金额,单位元 | ||
data.paymentDetail.trade.currency | string | Yes | 银行实际到账金额对应货币代码 | ||
data.paymentDetail.remark | string | Yes | maxLength: 256 | 附加数据,银行转账备注 | |
data.errorCode | string | Yes | maxLength: 32 | 订单失败错误码,详见[错误码列表] | |
data.errorMsg | string | Yes | maxLength: 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
| Field | Type | Required | Constraints | Description | Enum |
|---|---|---|---|---|---|
msg | string | Yes | 响应消息 | ||
code | string | Yes | 响应码 |
Response Example
json
{
"msg": "Success",
"code": "SUCCESS"
}