api

# 必要参数收集

在浏览器上收集下列参数

属性	类型	描述
language	string	购物者浏览器的navigator.language值（如IETF BCP 47中所定义）。
screenWidth	int	持卡人终端屏幕宽度（单位：像素）
javaEnabled	bool	持卡人终端是否能够执行Java。
javaScriptEnabled	bool	指示购物者的浏览器是否能够执行JavaScript。如果字段不存在，则假定为默认的`true`值。
acceptHeader	string	http响应头信息，示例值: text/html, application/xhtml+xml, application/xml;q=0.9, image/webp, image/apng, *;q=0.8
colorDepth	string
screenHeight	int	持卡人终端屏幕高度（单位：像素）
jetLag	int	UTC时间和持卡人浏览器本地时间之间的时差，以分钟为单位。
userAgent	string	浏览器用户代理信息示例值：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

# 填充browserInfo

请求PingPongChekout 下单并支付接口。在参数 browserInfo中上送以上参数。

请求报文示例：

{
  "accId":"2090020315464510103001",
  "clientId":"2090020315464510103",
  "signType":"SHA256",
  "sign":"{{Sign}}",
  "version":"1.0",
  "bizContent":{
    "captureDelayHours":"0",
    "amount":"3",
    "currency":"USD",
    "merchantTransactionId":"{{merchantTransactionId}}",
    "payResultUrl":"https://test-acquirerpay.pingpongx.com/qa/result.html",
    "payCancelUrl":"https://test-acquirerpay.pingpongx.com/qa/result.html",
    "notificationUrl":"https://test-acquirerpay.pingpongx.com/qa/result.html",
    "language":"en",
    "requestId":"{{requestId}}",
    "tradeCountry":"US",
    "shopperIP":"222.126.52.23",
    "paymentMethod":{
      "type":"scheme",
      "cardInfo":{
        "expireMonth":"12",
        "expireYear":"2024",
        "holderFirstName":"w",
        "holderLastName":"w",
        "number":"5200000000001096",
        "cvv":"103"
      }
    },
    "customer":{
      "firstName":"Jamesbb",
      "lastName":"LeBronbb",
      "email":"test@pingpongx.com",
      "phone":"9157030054"
    },
    "goods":[
      {
        "name":"商品名称mepsking1",
        "description":"商品描述",
        "sku":"产品SKU111",
        "unitPrice":"1000",
        "number":"1",
        "imgUrl":"https://xiu.mepsking.top/material/1/16606169805015585.png",
        "virtualProduct":"Y"
      }
    ],
    "shippingAddress":{
      "firstName":"Jamesbb",
      "lastName":"LeBronbb",
      "phone":"9157030054",
      "email":"3ds@pingpongx.com",
      "street":"3888 Austin Secret Lane",
      "postcode":"84723",
      "city":"Circleville",
      "state":"UT",
      "country":"US"
    },
    "billingAddress":{
      "firstName":"Jamesbb",
      "lastName":"LeBronbb",
      "phone":"9157030054",
      "email":"3ds@pingpongx.com",
      "street":"3888 Austin Secret Lane",
      "postcode":"84723",
      "city":"Circleville",
      "state":"UT",
      "country":"US"
    },
    "browserInfo":{
      "acceptHeader":"text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8",
      "colorDepth":"24",
      "jetLag":"480",
      "language":"nl-NL",
      "javaEnabled":"true",
      "screenHeight":"723",
      "screenWidth":"1536",
      "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
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84

// Make sure to add code blocks to your code group

# 是否需要3DS挑战

threeDUnionParams.threeDContinue为true时候需要触发3D挑战。
threeDUnionParams.threeDContinue为false时候将会跳转到商户的支付结果页shopperResultUrl。

# 重定向到3DS挑战页

从下单并支付接口的响应报文中获取threeDUnionParams.threeDRedirectUrl参数，通过GET方式跳转，随后PingPongCheckout提供的中间页将会自动重定向到3DS挑战页。

上次更新: 2024/05/14, 11:29:32