动账通知

• Endpoint: POST /balanceNotifyUrl
• Tags: 资金账户(老)

Description

当商户因为充值、转账、换汇、提现操作产生账户余额变动的时候，我们将会通过该API进行通知。

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	maxLength: 256	有效通知描述：Success
version	string	Yes		接口版本 当前值为：1.0
keyVersion	string	Yes	maxLength: 8	密钥版本 当前值为：1
appId	string	Yes	maxLength: 64	商户应用Id，PayerMax分配给商户应用的唯一标识
merchantNo	string	No	maxLength: 32	商户号，商户与PayerMax业务签约时生成的唯一标识
notifyTime	string	Yes	maxLength: 32	通知时间，符合rfc3339规范，格式：yyyy-MM-dd'T'HH:mm:ss.SSSXXX
notifyType	string	Yes	maxLength: 16	充值-DEPOSIT，汇兑-EXCHANGE，提现-WITHDRAW，转账-TRANSFER
data	object	Yes		数据体
data.amount	object	Yes		动账
data.amount.currency	string	Yes	maxLength: 3	动账币种
data.amount.value	string	Yes	maxLength: 204	动账金额
data.counterparty	object	Yes		交易对手方
data.counterparty.identifyId	string	Yes		交易对手标识，充提为银行账号，转汇为商户号
data.counterparty.identifyName	string	Yes		交易对手名称
data.direction	string	Yes		动账方向：INCREASE/DECREASE
data.relatedTradeNo	string	Yes	maxLength: 64	关联PayerMax交易流水号
data.exchange	object	No		汇率信息
data.exchange.ccyPair	string	Yes		货币对
data.exchange.rate	string	Yes		汇率
data.exchange.rateTime	string	Yes		汇率基准时间
data.fee	object	No		手续费
data.fee.value	string	Yes		手续费金额
data.fee.currency	string	Yes		手续费币种

Example

{
  "appId": "2222fd568ab5452b906a3d65a1fbac19",
  "code": "APPLY_SUCCESS",
  "data": {
    "amount": {
      "currency": "MYR",
      "value": "448.13"
    },
    "counterparty": {
      "identifyId": "P01010113842047",
      "identifyName": "自动化商户名1661913462216"
    },
    "direction": "DECREASE",
    "exchange": {
      "ccyPair": "USDMYR",
      "rate": "4.48130000",
      "rateTime": "2022-12-12T09:26:42.000Z"
    },
    "relatedTradeNo": "20221212092644TU2586897700363059"
  },
  "keyVersion": "1",
  "merchantNo": "P01010113842047",
  "msg": "Success",
  "notifyTime": "2022-12-12T09:26:57.628Z",
  "notifyType": "EXCHANGE",
  "version": "1.0"
}

Responses

200

Field	Type	Required	Constraints	Description	Enum
msg	string	Yes		响应消息
code	string	Yes		响应码

Response Example

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