账单支付校验接口

• Endpoint: POST /billPaymentValidationUrl
• Tags: 收单/账单支付

Description

此接口仅适用于菲律宾当地的Bill Payment支付方式。

PayerMax调用该接口请求商户获取本次支付操作的可行性（是否能够支付）。

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
referenceNo	string	Yes	maxLength: 64	商户的还款合同号，其中前五位由PayerMax生成。
amount	number	Yes		订单金额。
currency	string	Yes	maxLength: 3	订单币种。

Example

{
  "referenceNo": "TEST100001",
  "amount": 40.85,
  "currency": "PHP"
}

Responses

200

Field	Type	Required	Constraints	Description	Enum
code	string	Yes		返回码，’SUCCESS’代表成功
msg	string	Yes		返回描述，’Success’
data	object	No		响应data。
data.referenceNo	string	Yes	maxLength: 64	商户的还款合同号，其中前五位由PayerMax生成。
data.minAmount	number	Yes		最小支付金额。
data.maxAmount	number	Yes		最大支付金额。
data.currency	string	Yes	maxLength: 3	订单币种
data.confirmation	string	Yes	maxLength: 16	校验结果，"Y"或"N"。
data.failureReason	string	No	maxLength: 255	校验失败的原因。注意：confirmation为N时，该值必填。

Response Example

{
  "code": "SUCCESS",
  "msg": "Success.",
  "data": {
    "referenceNo": "TEST100001",
    "confirmation": "Y",
    "minAmount": 20,
    "maxAmount": 300,
    "currency": "PHP",
    "failureReason": ""
  }
}