Request Body Parameters

application/json

公共请求参数

bizContent

• customerObject可选
• goodsArray可选
• requestIdString(64)必填

  唯一请求号，全局唯一
• requestTimeString(13)必填

  商户侧请求时间。时间戳，到毫秒
• captureDelayHoursint按条件选

  • 0表示立即capture
  • -1表示手动capture，调用下单API成功之后还需要调用下预授权请款 ,本地支付不支持
• deviceSnString(64)必填

  设备序列号，用于指定目标POS机支付
• deviceModelString(64)必填

  设备型号，用于指定目标POS机支付
• merchantTransactionIdString(64)必填

  商户网站的订单流水号，订单唯一标识，可用于后续订单查询和对账
• amountString(12)必填

  交易金额，精确位数和币种有关，请查询附录交易币种
• currencyString(3)必填

  交易币种，ISO 4217 三位币种，具体支持币种⻅附录交易币种
• cashierDeviceIdString必填

  收银机设备序列号唯一ID
• shopperIpString(128)必填

  用户下单IP，支持 IPv4 格式
• paymentMethodString(64)必填

  指定支付方式，可选值：

  • Card Purchase - 刷卡支付
  • QR-POSScan - B扫C支付
  • QR Payment - C扫B支付
  • Octopus - 八达通刷卡支付（香港）
• timeExpireString(10)必填

  订单超期时间。1分钟到3天（低于1分钟默认取1分钟，高于3天默认取3天），不传默认3天。时间戳格式，单位：秒，示例值：1683530496
• tradeCountryString(2)必填

  用于指定交易国家ISO A2码（ISO 3166-1 alpha-2标准），默认取pingpong侧支持的国家，二字码⻅附录 国家代码
• notificationUrlString(255)可选

  商户自定义本次交易结果通知的地址。
  地址建议：请填写基于公网域名的完整 URL，推荐使用标准 Web 端口（HTTPS 默认 443，HTTP 默认 80），并确保该地址可稳定接收 PingPongCheckout 的异步通知。
• remarkString(255）可选

  商户扩展字段，可用于指定特定参数，会在响应体中原样返回

请求报文示例

{
  "accId": "2018092520455210043243",
  "bizContent": {
    "requestId": "REQ-15ZSIRMPKT1748591387687",
    "requestTime": "1748591387687",
    "timeExpire": "1748591687",
    "captureDelayHours": "0",
    "deviceSn": "NEC300067041",
    "deviceModel": "N950S",
    "amount": "121.23",
    "currency": "MYR",
    "paymentMethod": "QR Payment",
    "cashierDeviceId": "111",
    "shopperIp": "47.98.1.1",
    "merchantTransactionId": "PMT-15ZSIRMPKT1748591387687",
    "tradeCountry": "MY",
    "notificationUrl": "https://test-acquirerpay.pingpongx.com/qa/result.html",
    "remark": "payment test"
  },
  "clientId": "2018092520455210043",
  "sign": "C578137C7009700927502B1EAFB425893980832DDFC02434AD957FD364D9DE9D",
  "signType": "SHA256",
  "version": "1.0"
}

Responses Body Parameters

application/json

公共返回参数

bizContent

• transactionIdString(64)必填

  PingPong 交易流水号
• merchantTransactionIdString(64)必填

  商户网站的的交易流水号
• qrCodeString可选

  二维码编码。用于二维码支付场景，可使用此code码转为二维码图片进行展示
• qrUrlString可选

  二维码地址。用于二维码支付场景，展示二维码
• qrCodeExpiredString(10)可选

  二维码过期时间，时间戳格式，单位：秒
• remarkString(255)可选

  商户扩展字段

响应报文示例

{
  "accId": "2018092520455210043243",
  "bizContent": {
    "qrCodeExpired": "1748591687",
    "qrCode": "00020201021226580014A000000615000101065016640226100101570045614O01BDLA00015204539953034585406121.235802MY5925PINGPONG PAYMENT MALAYSIA6002MY62630120OS2025053001100002010311O01BDLA00010620OS20250530011000020182648305FDCB588DA5B1EDC5588660398CF3D8D3036F54F99A8B1710D4B04DBE5B066304FB33",
    "merchantTransactionId": "PMT-15ZSIRMPKT1748591387687",
    "remark": "payment test",
    "transactionId": "OS202505300010000201"
  },
  "clientId": "2018092520455210043",
  "code": "002000",
  "description": "Transaction processing"
}

下一页申请退款