商户接入指南 商户接入指南
  • 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

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

# 下单并支付

注意

Non-Hosted模式下卡支付必须接入风控组件

# 请求地址


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

    # 请求参数

    # 公共请求参数



    暂无数据

    # 业务参数



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

    暂无数据

    # 支付参数



    暂无数据

    # 风控参数



    暂无数据


    # 响应参数

    # 公共响应参数



    暂无数据

    # 业务响应参数




    # 请求报文示例



        {
        "accId": "2018092714313010016291",
        "clientId": "2018092714313010016",
        "signType": "SHA256",
        "sign": "898A3CBE981B3E2BF4E2B8D1A817D7E23EF93BC4293993EE545E36F4C87F2E79",
        "version": "1.0",
        "bizContent":"{\"captureDelayHours\":0,\"merchantSource\":\"0\",\"amount\":100,\"currency\":\"USD\",\"requestId\":\"PMT-9ICSCWF9H51695189441815\",\"payCancelUrl\":\"https://test-acquirerpay.pingpongx.com/qa/notify\",\"notificationUrl\":\"https://test-acquirerpay.pingpongx.com/qa/notify\",\"merchantTransactionId\":\"PMT-9ICSCWF9H51695189441815\",\"shopperIP\":\"192.168.1.1\",\"paymentMethod\":{\"type\":\"scheme\",\"cardInfo\":{\"number\":\"5204740000001002\",\"holderFirstName\":\"James\",\"holderLastName\":\"LeBron\",\"expireMonth\":\"12\",\"expireYear\":\"2027\",\"cvv\":\"840\"}},\"customer\":{\"email\":\"pass@pingpongx.com\"},\"goods\":{\"name\":\"zhangsan\",\"unitPrice\":\"10\",\"number\":\"1\",\"imgUrl\":\"https://m.baidu.com/s?word=%E7%99%BE%E5%BA%A6%E7%83%AD%E6%90%9C&tn&from=1020854c&sa=tre_dl_gh_logo_wj\"},\"billingAddress\":{\"street\":\"701 Brickell Avenue, Suite 2700\",\"postcode\":\"84723\",\"city\":\"Miami\",\"state\":\"UT\",\"country\":\"US\"},\"browserInfo\":{\"acceptHeader\":\"content-type=application/x-www-form-urlencoded;accept=*/*;cache-control=no-cache;postman-token=cf489264-5378-4d5d-a86c-72c86a408c03;accept-encoding=gzip, deflate;content-length=588;connection=keep-alive;\",\"colorDepth\":\"32\",\"jetLag\":\"480\",\"screenHeight\":\"1980\",\"screenWidth\":\"1080\",\"userAgent\":\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/72.0.3626.121 Safari/537.36\",\"windowSize\":\"05\"},\"device\":{\"orderTerminal\":\"02\"}}"
        }
      
      1
      2
      3
      4
      5
      6
      7
      8
      curl --location 'https://sandbox-acquirer-payment.pingpongx.com/v4/payment/unifiedPay' \
      --header 'Content-Type: application/json' \
      --header 'Cookie: SESSION=YmIwY2EwMDItZjc1NC00YjFjLWIyMGUtNmNhZGRkNmI5ZDAw; SESSION=YmIwY2EwMDItZjc1NC00YjFjLWIyMGUtNmNhZGRkNmI5ZDAw' \
      --data-raw '{"accId":"2018092714313010016291","bizContent":"{\"captureDelayHours\":0,\"merchantSource\":\"0\",\"amount\":100,\"currency\":\"USD\",\"requestId\":\"PMT-9ICSCWF9H51695189441815\",\"payCancelUrl\":\"https://test-acquirerpay.pingpongx.com/qa/notify\",\"notificationUrl\":\"https://test-acquirerpay.pingpongx.com/qa/notify\",\"merchantTransactionId\":\"PMT-9ICSCWF9H51695189441815\",\"shopperIP\":\"192.168.1.1\",\"paymentMethod\":{\"type\":\"scheme\",\"cardInfo\":{\"number\":\"5204740000001002\",\"holderFirstName\":\"James\",\"holderLastName\":\"LeBron\",\"expireMonth\":\"12\",\"expireYear\":\"2027\",\"cvv\":\"840\"}},\"customer\":{\"email\":\"pass@pingpongx.com\"},\"goods\":{\"name\":\"zhangsan\",\"unitPrice\":\"10\",\"number\":\"1\",\"imgUrl\":\"https://m.baidu.com/s?word=%E7%99%BE%E5%BA%A6%E7%83%AD%E6%90%9C&tn&from=1020854c&sa=tre_dl_gh_logo_wj\"},\"billingAddress\":{\"street\":\"701 Brickell Avenue, Suite 2700\",\"postcode\":\"84723\",\"city\":\"Miami\",\"state\":\"UT\",\"country\":\"US\"},\"browserInfo\":{\"acceptHeader\":\"content-type=application/x-www-form-urlencoded;accept=*/*;cache-control=no-cache;postman-token=cf489264-5378-4d5d-a86c-72c86a408c03;accept-encoding=gzip, deflate;content-length=588;connection=keep-alive;\",\"colorDepth\":\"32\",\"jetLag\":\"480\",\"screenHeight\":\"1980\",\"screenWidth\":\"1080\",\"userAgent\":\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/72.0.3626.121 Safari/537.36\",\"windowSize\":\"05\"},\"device\":{\"orderTerminal\":\"02\"}}","clientId":"2018092714313010016","sign":"898A3CBE981B3E2BF4E2B8D1A817D7E23EF93BC4293993EE545E36F4C87F2E79","signType":"SHA256","version":"1.0"}'
      
      
      1
      2
      3
      4
      5
      // Make sure to add code blocks to your code group


      # 响应报文示例


        {
          "accId": "2018092714313010016291",
          "bizContent": "{\"requestId\":\"PMT-9ICSCWF9H51695189441815\",\"merchantTransactionId\":\"PMT-9ICSCWF9H51695189441815\",\"amount\":\"100.000000\",\"threeDUnionParams\":{\"threeDContinue\":\"false\"},\"transactionId\":\"2023092050004595\",\"threeDContinue\":\"false\",\"paymentMethod\":{\"type\":\"scheme\"},\"captureDelayHours\":0,\"status\":\"FAILED\"}",
          "clientId": "2018092714313010016",
          "code": "301002",
          "description": "Transaction declined (Do not honor,Please contact the issuing bank to confirm the bank card payment limit)",
          "sign": "85E02B2A474DA7D135DE844A202015594C874E4A2A06394BA7DF00071FC4A6D1",
          "signType": "SHA256"
        }
        
        1
        2
        3
        4
        5
        6
        7
        8
        9
        {
          "accId": "2018092714313010016289",
          "bizContent": "{\"issuerInfo\":{},\"remark\":\"Remark customer defined txt\",\"transactionTime\":\"1710761705000\",\"requestId\":\"PShop2024031819351FB\",\"merchantTransactionId\":\"PShop2024031819351FB\",\"currency\":\"USD\",\"exchangedAmount\":\"3\",\"payResultUrl\":\"https://test-acquirerpay.pingpongx.com/qa/result.html\",\"exchangedCurrency\":\"USD\",\"threeDSInfo\":{\"cavv\":\"\",\"authenticationResult\":\"\",\"liabilityShift\":\"N\",\"eci\":\"\",\"authentication3DSecure\":\"5446891f-880a-40f2-ad89-0cc54fb73e11\",\"specificationVersion\":\"2.1.0\"},\"amount\":\"3.000000\",\"authenticationInfo\":{\"avsResult\":\"Unknown\",\"cvvResult\":\"Y\",\"threeDSecure\":\"Y\"},\"cardInfo\":{\"firstName\":\"Lionel\",\"isoCountryA2\":\"MY\",\"lastName\":\"Messi\",\"lastFourDigits\":\"1096\",\"cardLevel\":\"STANDARD\",\"paymentBrand\":\"MASTERCARD\",\"cardType\":\"CREDIT\",\"issuringBank\":\"PUBLIC BANK BERHAD\",\"firstSixDigits\":\"520000\",\"isoCountry\":\"MALAYSIA\"},\"threeDUnionParams\":{\"acsUrl\":\"https://centinelapistag.cardinalcommerce.com/V2/Cruise/StepUp\",\"threeDRedirectUrl\":\"https://sandbox-acquirer-static.pingpongx.com/payment/threeDs.html?code=eyJhY3NVcmwiOiJodHRwczovL2NlbnRpbmVsYXBpc3RhZy5jYXJkaW5hbGNvbW1lcmNlLmNvbS9WMi9DcnVpc2UvU3RlcFVwIiwiYXV0aEFjY2Vzc1Rva2VuIjoiZXlKaGJHY2lPaUpJVXpJMU5pSXNJblI1Y0NJNklrcFhWQ0o5LmV5SnFkR2tpT2lJellqYzVOell3TUMxa09UUmtMVFEwT0dVdE9ERXlOaTAyWVdJNE1XWXhZMkUzWm1RaUxDSnBZWFFpT2pFM01UQTNOakUzTURZc0ltbHpjeUk2SWpWa1pEZ3pZbVl3TUdVME1qTmtNVFE1T0dSalltRmpZU0lzSW1WNGNDSTZNVGN4TURjMk5UTXdOaXdpVDNKblZXNXBkRWxrSWpvaU5qSXlPREZoTXpSaE1HTXhaakF6WVRFME5qbGxOV0V3SWl3aVVHRjViRzloWkNJNmV5SkJRMU5WY213aU9pSm9kSFJ3Y3pvdkx6QnRaWEpqYUdGdWRHRmpjM04wWVdjdVkyRnlaR2x1WVd4amIyMXRaWEpqWlM1amIyMHZUV1Z5WTJoaGJuUkJRMU5YWldJdlkzSmxjUzVxYzNBaUxDSlFZWGxzYjJGa0lqb2laWGxLZEZwWVRucFpWMlJzVmtoc2QxcFRTVFpKYTA1VFdsaEZhVXhEU25SYVdFNTZXVmRrYkZadFZubGpNbXgyWW1sSk5rbHFTWFZOVXpSM1NXbDNhV1JIYUhsYVYxWkZWVEZPYkdOdVdteGpiRko1V1ZjMWVsTlZVV2xQYVVreFRrUlJNazlFYTNoYWFUQTBUMFJDYUV4VVVYZGFha2wwV1ZkUk5FOVRNSGRaTWsweFRrZGFhVTU2VG14TlZFVnBURU5LYUZrelRsVmpiVVoxWXpCc1JVbHFiMmxQUkdzelRVZEdhbGw2YTNSTmFsVjRXbWt3TUUxcVNYcE1WR3Q0VFdwamRGbDZaM2xPVkdoclRsUk9iRTVVYXpGSmFYZHBXVEpvYUdKSGVHeGliV1JzVmpKc2RWcEhPVE5WTW13MldsTkpOa2xxUVhsSmJqQWlMQ0pVY21GdWMyRmpkR2x2Ymtsa0lqb2lUbmx2VGtkUVZYUXhOV3N5ZVROWFpHcG9hVEFpZlN3aVQySnFaV04wYVdaNVVHRjViRzloWkNJNmRISjFaU3dpVW1WMGRYSnVWWEpzSWpvaWFIUjBjSE02THk5ellXNWtZbTk0TFdGamNYVnBjbVZ5TFhCaGVXMWxiblF1Y0dsdVozQnZibWQ0TG1OdmJTOTBhSEpsWlVSVEwwTjVZbVZ5VTI5MWNtTmxMM0psWkdseVpXTjBMMmd3VEcxWlRIWmtWa3RCT0hOQ01XbzRRV0Y0VEZGaVJGUkpTVWc0VkdST2FVMXJSemw2VWxCSE5VRnNWamhXTUZvMWNERXdiMjV5ZW5ad2VWTmZXV1J3TUhGa1NsRTNiVTgyY0VkZlNXZzNXR294TUhCM2R5MXlXbWczVWpKdlFUaHhUMGt5WmxOUFRIbGpZV2xEYTNCNFZIaGlSbUZ4VTNSZlYyeHVlbDlsU0hkRlZWTnlOMGhCZEVWaGQzRjFTbFJXZWpKNlVUMDlJbjAuYnNBMk5pekNFMkZlX25IV3g4YkFrX0wwU0ZsdVQxajRtenppeHBYcmNBOCIsImNoYW5uZWwiOiJDWUJTIn0=\",\"threeDChannel\":\"CyberSource\",\"threeDResult\":\"{\\\"ACSUrl\\\":\\\"https://centinelapistag.cardinalcommerce.com/V2/Cruise/StepUp\\\",\\\"acsTransId\\\":\\\"8970acc9-251f-4223-9127-c8258d53e595\\\",\\\"authAccessToken\\\":\\\"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIzYjc5NzYwMC1kOTRkLTQ0OGUtODEyNi02YWI4MWYxY2E3ZmQiLCJpYXQiOjE3MTA3NjE3MDYsImlzcyI6IjVkZDgzYmYwMGU0MjNkMTQ5OGRjYmFjYSIsImV4cCI6MTcxMDc2NTMwNiwiT3JnVW5pdElkIjoiNjIyODFhMzRhMGMxZjAzYTE0NjllNWEwIiwiUGF5bG9hZCI6eyJBQ1NVcmwiOiJodHRwczovLzBtZXJjaGFudGFjc3N0YWcuY2FyZGluYWxjb21tZXJjZS5jb20vTWVyY2hhbnRBQ1NXZWIvY3JlcS5qc3AiLCJQYXlsb2FkIjoiZXlKdFpYTnpZV2RsVkhsd1pTSTZJa05TWlhFaUxDSnRaWE56WVdkbFZtVnljMmx2YmlJNklqSXVNUzR3SWl3aWRHaHlaV1ZFVTFObGNuWmxjbFJ5WVc1elNVUWlPaUkxTkRRMk9Ea3haaTA0T0RCaExUUXdaakl0WVdRNE9TMHdZMk0xTkdaaU56TmxNVEVpTENKaFkzTlVjbUZ1YzBsRUlqb2lPRGszTUdGall6a3RNalV4WmkwME1qSXpMVGt4TWpjdFl6Z3lOVGhrTlRObE5UazFJaXdpWTJoaGJHeGxibWRsVjJsdVpHOTNVMmw2WlNJNklqQXlJbjAiLCJUcmFuc2FjdGlvbklkIjoiTnlvTkdQVXQxNWsyeTNXZGpoaTAifSwiT2JqZWN0aWZ5UGF5bG9hZCI6dHJ1ZSwiUmV0dXJuVXJsIjoiaHR0cHM6Ly9zYW5kYm94LWFjcXVpcmVyLXBheW1lbnQucGluZ3Bvbmd4LmNvbS90aHJlZURTL0N5YmVyU291cmNlL3JlZGlyZWN0L2gwTG1ZTHZkVktBOHNCMWo4QWF4TFFiRFRJSUg4VGROaU1rRzl6UlBHNUFsVjhWMFo1cDEwb25yenZweVNfWWRwMHFkSlE3bU82cEdfSWg3WGoxMHB3dy1yWmg3UjJvQThxT0kyZlNPTHljYWlDa3B4VHhiRmFxU3RfV2xuel9lSHdFVVNyN0hBdEVhd3F1SlRWejJ6UT09In0.bsA2NizCE2Fe_nHWx8bAk_L0SFluT1j4mzzixpXrcA8\\\",\\\"authenticationTransactionId\\\":\\\"NyoNGPUt15k2y3Wdjhi0\\\",\\\"cardEnrolled\\\":\\\"Y\\\",\\\"channelName\\\":\\\"CyberSource\\\",\\\"dsTransId\\\":\\\"3ea4da9a-d542-4f7c-bb33-2442ce3b0044\\\",\\\"paReq\\\":\\\"eyJtZXNzYWdlVHlwZSI6IkNSZXEiLCJtZXNzYWdlVmVyc2lvbiI6IjIuMS4wIiwidGhyZWVEU1NlcnZlclRyYW5zSUQiOiI1NDQ2ODkxZi04ODBhLTQwZjItYWQ4OS0wY2M1NGZiNzNlMTEiLCJhY3NUcmFuc0lEIjoiODk3MGFjYzktMjUxZi00MjIzLTkxMjctYzgyNThkNTNlNTk1IiwiY2hhbGxlbmdlV2luZG93U2l6ZSI6IjAyIn0\\\",\\\"threeDRequestId\\\":\\\"PShop2024031819351FB\\\",\\\"threeDServerTransactionId\\\":\\\"5446891f-880a-40f2-ad89-0cc54fb73e11\\\",\\\"version\\\":\\\"2.1.0\\\"}\",\"threeDContinue\":\"true\"},\"transactionId\":\"2024031850032495\",\"threeDContinue\":\"true\",\"paymentMethod\":{\"type\":\"scheme\"},\"captureDelayHours\":0,\"status\":\"PROCESSING\"}",
          "clientId": "2018092714313010016",
          "code": "002000",
          "description": "Transaction processing",
          "sign": "5E860599CBBDB0CD1EB1C7C195D5EFA5",
          "signType": "MD5"
        }
        
        1
        2
        3
        4
        5
        6
        7
        8
        9
        // Make sure to add code blocks to your code group
        上次更新: 2024/03/19, 10:56:21

        ← 下单(Hosted模式) 交易查询→

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