Skip to content
请求示例json
{
  "orderAmount": "15000",
  "payMethod": "EASYPAISA",
  "merchantOrderNo": "PKCS202604170001",
  "callbackUrl": "https://merchant.example.com/cashier/notify",
  "redirectUrl": "https://merchant.example.com/cashier/return",
  "customerName": "Ali Khan",
  "customerPhone": "3134567890",
  "customerEmail": "cashier.user@gmail.com",
  "timestamp": "1742204301456"
}
200json
{
  "message": "success",
  "code": "00000",
  "timestamp": 1742204304622,
  "success": true,
  "data": {
    "platformOrderNo": "pkcas7n3d5r1k8m2",
    "orderStatus": "PENDING",
    "message": "CREATED",
    "paymentLink": "https://casher.pk.zoxupay.com/PKCS202604170001"
  }
}

创建收银台 ​

生成巴基斯坦收银台链接,用户可通过页面完成付款。

POST/api/v2/pay/collect

用于创建收银台订单并返回可直接打开的支付链接。

请求头 ​

x-access-keystring必选

商户访问标识

signaturestring必选

请求签名

请求参数 ​

timestampstring必选

毫秒级时间戳字符串,例如:1715941383720

orderAmountstring必选

支付金额,不允许小数,最低金额 100 PKR

payMethodstring必选

支持的支付类型:EASYPAISA、JAZZCASH、QR

merchantOrderNostring必选

交易号,应唯一;推荐格式:YYYYMMDDHHMMSS + 随机数

callbackUrlstring必选

异步回调 URL

redirectUrlstring可选

支付成功后的重定向页面,例如:https://merchant.example.com/cashier/return。如果未提供,系统将重定向到默认成功页面

customerNamestring必选

付款人姓名

customerPhonestring必选

付款人手机号。以 3 开头的 10 位数字或以 03 开头的 11 位数字,必须是真实账户

customerEmailstring必选

付款人邮箱,建议使用 gmail.com 域名,例如 cashier.user@gmail.com

响应参数 ​

messagestring必返

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

codestring必返

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

timestampstring必返

交易时间

successboolean必返

接口调用结果

dataobject必返

返回对象

data.platformOrderNostring必返

唯一平台订单号

data.orderStatusstring必返

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

data.messagestring必返

状态描述消息

data.paymentLinkstring必返

支付链接,即收银台 URL