EN开始接入
Zoxupay

简体中文

English

简体中文

English

Appearance

请求示例json
{
  "timestamp": "1742205605123",
  "merchantOrderNo": "PHC202604170001",
  "orderAmount": "1200",
  "payMethod": "MAYA",
  "callbackUrl": "https://merchant.example.com/payments/notify",
  "redirectUrl": "https://merchant.example.com/payments/return"
}
200json
{
  "message": "success",
  "code": "00000",
  "timestamp": 1742205607984,
  "success": true,
  "data": {
    "merchantOrderNo": "PHC202604170001",
    "platformOrderNo": "phpay8q2m4x7c1n9",
    "payInfo": {
      "paymentContent": "https://checkout.ph.zoxupay.com/PHC202604170001"
    },
    "orderStatus": "PENDING",
    "message": "Paying"
  }
}

收款 ​

发起菲律宾收款订单，平台返回支付链接、支付账户信息或二维码信息。

POST/api/v2/pay/submit

用于创建收款订单并获取平台侧受理结果与支付信息。

请求头 ​

x-access-keystring必选

商户访问标识

signaturestring必选

请求签名

请求参数 ​

timestampstring必选

毫秒级时间戳字符串，例如：1715941383720

orderAmountstring必选

支付金额，建议使用整数字符串

payMethodstring必选

支持的支付类型：GRABPAY、MAYA、QRPH、GCASH2

merchantOrderNostring必选

交易编号，应唯一；建议格式：YYYYMMDDHHMMSS + 随机数

callbackUrlstring必选

异步回调 URL

redirectUrlstring必选

支付成功后的重定向页面

响应参数 ​

messagestring必返

请求结果。返回 success 仅表示本次接口调用成功，不可做商户端逻辑判断

codestring必返

业务状态码。00000 表示请求受理成功，其他 5 位数字表示具体错误原因，请参考错误码页

timestampstring必返

交易时间

successboolean必返

接口调用结果

dataobject必返

返回对象

data.merchantOrderNostring必返

返回的商户交易编号

data.platformOrderNostring必返

唯一平台订单号

data.payInfoobject必返

支付信息对象，不同支付方式返回字段可能不同

data.payInfo.paymentContentstring可选

支付内容，可能为支付链接、QRPH 二维码字符串或 GCASH 官方链接

data.orderStatusstring必返

订单状态。SUCCESS 表示成功，PENDING 表示处理中，FAILED 表示失败，EXPIRED 表示过期，CANCELLED 表示取消，REFUNDED 表示已退款

data.messagestring必返

状态描述消息

Copyright © 2026 Zoxupay