Request Body Parameters

application/json

Common Request Parameters

bizContent

• customerObjectOptional
• goodsArrayOptional
• requestIdString(64)Required

  Unique request number, globally unique
• captureDelayHoursintRequired

  0=immediate capture, -1=manual capture, local payments do not support manual capture
• merchantTransactionIdString(64)Required

  Merchant order number, unique identifier for the order, can be used for subsequent order queries and reconciliation
• amountString(12)Required

  Transaction amount, precision depends on currency, see Transaction Currencies
• currencyString(3)Required

  Transaction currency, ISO 4217 three-letter currency code, see Transaction Currencies
• tipsAmountString(12)Optional

  Tips amount, already included in amount, recorded separately here for information
• shopperIpString(128)Required

  User IP address for order placement, supports IPv4 format
• paymentMethodString(64)Required

  Specified payment method, provided by PingPong
• timeExpireString(10)Optional

  Order expiration time. 1 minute to 3 days (less than 1 minute defaults to 1 minute, more than 3 days defaults to 3 days), defaults to 3 days if not provided. Timestamp format, unit: seconds
• tradeCountryString(2)Optional

  Transaction country two-letter code, defaults to countries supported by PingPong, see Country Codes
• notificationUrlString(255)Optional

  Custom notification URL for this transaction result by the merchant.
  URL recommendation: use a complete URL with a publicly reachable domain name. Standard web ports are recommended (HTTPS defaults to 443 and HTTP defaults to 80). Ensure the URL can reliably receive PingPongCheckout asynchronous notifications.
• remarkString(255)Optional

  Merchant extended fields, can be used to specify certain parameters, will be returned as is in the response

请求报文示例

{
  "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

Common Response Parameters

bizContent

• requestIdString(64)Required

  Unique request number
• transactionIdString(64)Optional

  PingPong transaction ID

响应报文示例

{
  "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"
  }
}

Previous pageHeartbeat API

Next pageTransaction Query