商户接入指南 商户接入指南
  • V2 (opens new window)
  • V3 (opens new window)
  • V4-English (opens new window)
  • V4-专业版 (opens new window)
  • V2 (opens new window)
  • V3 (opens new window)
  • V4-English (opens new window)
  • V4-专业版 (opens new window)
  • 概述

    • 起步
    • 对接流程
    • 联调资源
  • 服务

    • Checkout

      • 概览
      • Hosted
      • Non-Hosted
      • APIs

        • 下单(Hosted模式)
          • 请求地址
          • 请求参数
          • 响应参数
        • 下单并支付(Non-Hosted模式)
        • 交易查询
        • 申请退款
        • 退款查询
        • 预授权确认
        • 预授权确认查询
        • 预授权取消
        • 预授权取消查询
        • 异步通知
        • 上传物流信息
        • SFTP对账单下载
    • 订阅

      • 概览
      • 接入流程
    • 线下付款码支付

      • 接入流程
    • Tokenization

      • 概览
      • 接入流程
      • APIs

    • 风险管理

      • 概览
      • Dynamic 3D Secure
      • Disputes
      • APIs

    • 一键支付

      • 概览
      • 接入流程
      • APIs

    • ApplePay

    • GooglePay

    • KYB

    • 支付链

    • 建站工具

    • 工具

  • 附录

  • v4

下单接口(Hosted模式)

# 下单接口

# 请求地址


    https://sandbox-acquirer-payment.pingpongx.com/v4/payment/prePay
    
    1
    https://acquirer-payment.pingpongx.com/v4/payment/prePay
    
    1
    // Make sure to add code blocks to your code group

    同一笔支付订单(merchantTransactionId)修改入参发起新的支付请求,还是会取第一次请求传入的参数。如果需要变更入参,则需要修改 merchantTransactionId 重新发起支付请求。

    # 请求参数

    # 公共请求参数



    暂无数据

    # 业务参数



    参数必填属性说明:必填(M),可选(O),条件必填(C)。 POST JSON

    暂无数据

    # 风控参数



    暂无数据


    # 响应参数

    # 公共响应参数



    暂无数据

    # 业务响应参数


    参数字段 参数属性 参数说明
    transactionId String(64) PingPong 交易流水号
    merchantTransactionId String(64) 商户网站的的交易流水号
    amount String(12) 交易金额
    currency String(3) 交易币种
    remark String(255) 商户扩展字段
    token String 本次结账请求的唯一标示,用于初始化JS-SDK
    innerJsUrl String JS-SDK的加载地址
    paymentUrl String PingPong 支付收银台地址


    # 请求报文示例



        {
        "accId": "2018092714313010016291",
        "clientId": "2018092714313010016",
        "signType": "SHA256",
        "sign": "28178F3C0B0AF10343F715211B9C7791AB4CF091EB4580505E053318E8F37B85",
        "version": "1.0",
        "bizContent":"{\"captureDelayHours\":\"0\",\"amount\":\"1000\",\"currency\":\"USD\",\"merchantTransactionId\":\"PMT-PR5GFUNZQP1695182276082\",\"payResultUrl\":\"https://test-acquirerpay.pingpongx.com/qa/result.html\",\"payCancelUrl\":\"https://test-acquirerpay.pingpongx.com/qa/result.html\",\"shopperIP\":\"222.126.52.23\",\"customer\":{\"identificationId\":\"211\",\"lastName\":\"LeBronbb\",\"email\":\"test@pingpongx.com\",\"phone\":\"9157030054\"}}"
        }
      
      1
      2
      3
      4
      5
      6
      7
      8
      curl --location 'https://sandbox-acquirer-payment.pingpongx.com/v4/payment/prePay' \
      --header 'Content-Type: application/json' \
      --header 'Cookie: SESSION=YWY4NmMxZGYtNTZlMy00Y2Q5LWJhOWMtMjEyZDhiYTkyODFl; SESSION=YWY4NmMxZGYtNTZlMy00Y2Q5LWJhOWMtMjEyZDhiYTkyODFl' \
      --data-raw '{
        "accId": "2018092714313010016291",
        "clientId": "2018092714313010016",
        "signType": "SHA256",
        "sign": "28178F3C0B0AF10343F715211B9C7791AB4CF091EB4580505E053318E8F37B85",
        "version": "1.0",
        "bizContent":"{\"captureDelayHours\":\"0\",\"amount\":\"1000\",\"currency\":\"USD\",\"merchantTransactionId\":\"PMT-PR5GFUNZQP1695182276082\",\"payResultUrl\":\"https://test-acquirerpay.pingpongx.com/qa/result.html\",\"payCancelUrl\":\"https://test-acquirerpay.pingpongx.com/qa/result.html\",\"shopperIP\":\"222.126.52.23\",\"customer\":{\"identificationId\":\"211\",\"lastName\":\"LeBronbb\",\"email\":\"test@pingpongx.com\",\"phone\":\"9157030054\"}}"
      }'
      
      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      // Make sure to add code blocks to your code group


      # 响应报文示例


      {
        "accId": "2018092714313010016291",
        "bizContent": "{\"amount\":\"1000\",\"paymentUrl\":\"https://sandbox-acquirer-payment-ssr.pingpongx.com/v3/checkout?token=EU:vr_YVR8u7rn7C1gG97DOg9_-Y66ubtNtoayJ_wiEEzdCnxCHYIk0pXordJYBjq1g\",\"transactionId\":\"2023092050004591\",\"token\":\"EU:vr_YVR8u7rn7C1gG97DOg9_-Y66ubtNtoayJ_wiEEzdCnxCHYIk0pXordJYBjq1g\",\"merchantTransactionId\":\"PMT-PR5GFUNZQP1695182276082\",\"currency\":\"USD\",\"innerJsUrl\":\"https://pay-cdn.pingpongx.com/production/static/sdk/ppPay.min.js?token=EU:vr_YVR8u7rn7C1gG97DOg9_-Y66ubtNtoayJ_wiEEzdCnxCHYIk0pXordJYBjq1g\"}",
        "clientId": "2018092714313010016",
        "code": "000000",
        "description": "Transaction succeeded",
        "sign": "337DE4525BECC73D56E262E04CCCC210C7BA70C78D48DA3BB128E4FEC6D01561",
        "signType": "SHA256"
      }
      
      1
      2
      3
      4
      5
      6
      7
      8
      9
      上次更新: 2024/01/12, 18:02:23

      ← Non-Hosted 下单并支付(Non-Hosted模式)→

      杭州乒乓智能技术有限公司 | Copyright © 2015-2024 checkout.pingpongx.com.All Rights Reserved.
      • 跟随系统
      • 浅色模式
      • 深色模式
      • 阅读模式