Request Body Parameters

application/json

公共请求参数

bizContent

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

  唯一请求号,全局唯一
• captureDelayHoursint必填

  0=立即capture,-1=手动capture,本地支付不支持手动capture
• merchantTransactionIdString(64)必填

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

  交易金额,精确位数与币种相关,详见交易币种
• currencyString(3)必填

  交易币种,ISO 4217三位币种代码,详见交易币种
• tipsAmountString(12)可选

  小费金额,amount中已包含小费金额,这里只是单独记录小费信息
• shopperIpString(128)必填

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

  指定支付方式,由PingPong提供
• timeExpireString(10)可选

  订单超期时间。1分钟~3天(低于1分钟默认取1分钟,高于3天默认取3天),不传默认3天。时间戳格式,单位:秒
• tradeCountryString(2)可选

  交易国家二字码,默认取PingPong侧支持的国家,详见国家代码
• notificationUrlString(255)可选

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

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

请求报文示例

{
  "accId": "PPX_ACC_202312001",
  "clientId": "PPX_MCH_20230001",
  "signType": "SHA256",
  "sign": "9F86D081884C7D659A2FEAA0C55AD015A3BF4F1B2B0B822CD15D6C15B0F00A08",
  "version": "1.0",
  "event": "PAY",
  "requestTime": "1683530496000",
  "bizContent": {
    "requestId": "SAAS_REQ_20231212001",
    "captureDelayHours": 0,
    "merchantTransactionId": "MCH_ORDER_20231212001",
    "amount": "100.00",
    "currency": "USD",
    "tipsAmount": "5.00",
    "shopperIp": "192.168.1.100",
    "paymentMethod": "ShowCode",
    "timeExpire": "1683616896",
    "tradeCountry": "US",
    "notificationUrl": "https://merchant.com/notify",
    "remark": "测试订单",
    "customer": {
      "firstName": "John",
      "lastName": "Doe",
      "email": "john.doe@example.com",
      "phone": "+8613800138000",
      "birthDate": "1990-01-01"
    },
    "goods": [
      {
        "name": "iPhone 15",
        "description": "智能手机",
        "sku": "IPHONE15-128G",
        "unitPrice": "100.00",
        "number": "1",
        "imgUrl": "https://example.com/iphone15.jpg",
        "virtualProduct": "N"
      }
    ]
  }
}

Responses Body Parameters

application/json

公共返回参数

bizContent

• requestIdString(64)必填

  唯一请求号
• transactionIdString(64)可选

  PingPong交易流水号

响应报文示例

{
  "accId": "PPX_ACC_202312001",
  "clientId": "PPX_MCH_20230001",
  "signType": "SHA256",
  "sign": "BAEA4D56D885D6BD449BFFA2D9F117ECEDA662C85197A19050CA0C18CC64B871",
  "event": "PAY_ACCEPTANCE",
  "code": "0",
  "description": "受理成功",
  "requestTime": "1683530497000",
  "bizContent": {
    "requestId": "SAAS_REQ_20231212001",
    "transactionId": "PPX_TXN_202312120001"
  }
}

上一页GMC串口心跳接口

下一页GMC串口交易查询接口