单笔交易查询

# 单笔交易查询

注意 :

请在交易同步返回之后调用查询接口，否则可能会发生查询异常的情况

# 请求地址

POST https://sandbox-acquirer-payment.pingpongx.com/v3/query

POST https://acquirer-payment.pingpongx.com/v3/query

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

# 请求参数

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

参数字段	参数类型	参数属性	参数说明
requestId	String(64)	M	唯一请求ID
accId	String(64)	M	PingPong 商户店铺编号
signType	String(32)	M	签名规约，支持 MD5、SHA256，具体⻅本文签名规约一栏
sign	String(256)	M	签名内容，具体⻅本文“签名规约”一栏
transactionId	String(64)	C	PingPong 交易流水号，与 merchantTransactionId 至少上送一项
merchantTransactionId	String(64)	C	商户网站交易流水号，与 transactionId 至少上送一项

# 响应参数

暂无数据

# 响应报文示例

{
  "accId": "2018092714313010016291",
  "amount": "100.00",
  "authenticationInfo": {
    "avsResult": "Unknown",
    "cvvResult": "Y",
    "threeDSecure": "N"
  },
  "cardInfo": {
    "cardLevel": "",
    "cardType": "CREDIT",
    "firstName": "asdasd",
    "firstSixDigits": "420000",
    "ipCountry": "CN",
    "isoCountry": "UNITED STATES",
    "isoCountryA2": "US",
    "issuringBank": "JPMORGAN CHASE BANK, N.A.",
    "lastFourDigits": "0000",
    "lastName": "asdasd",
    "paymentBrand": "VISA"
  },
  "channel": "PingPong",
  "checkoutType": "NORMAL",
  "clientId": "2018092714313010016",
  "code": "000000",
  "currency": "USD",
  "description": "Transaction succeeded",
  "language": "en",
  "merchantTransactionId": "21975fe5026d252441406916307930ea",
  "notificationUrl": "https://devapi.ihatoo.com:8888/order/trade/notice/notifyTradOrder",
  "paymentBrand": "VISA",
  "paymentType": "DEBIT",
  "relateTransactionId": "PS23080211422619513",
  "shopperResultUrl": "www.baidu.com",
  "sign": "5E5205B5C77FD39FCCA6EDF9E5480301DC0DBA3B369BFD8A4513A06DEA38E062",
  "signType": "SHA256",
  "status": "SUCCESS",
  "transactionId": "PS23080211422619513",
  "transactionTime": "1690947747000"
}

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

{
  "accId": "2023012814070510202001",
  "amount": "2.00",
  "authenticationInfo": {
    "avsResult": "Unknown",
    "cvvResult": "Y",
    "threeDSecure": "N"
  },
  "cardInfo": {
    "cardLevel": "",
    "cardType": "CREDIT",
    "firstName": "Jamesbb",
    "firstSixDigits": "444433",
    "ipCountry": "CN",
    "isoCountry": "UNITED STATES",
    "isoCountryA2": "US",
    "issuringBank": "",
    "lastFourDigits": "1111",
    "lastName": "LeBronbb",
    "paymentBrand": "VISA"
  },
  "channel": "PingPong",
  "checkoutType": "NORMAL",
  "clientId": "2023012814070510202",
  "code": "000000",
  "currency": "USD",
  "description": "Transaction succeeded",
  "language": "en",
  "merchantTransactionId": "PMT-1690944183409",
  "notificationUrl": "https://test-acquirerpay.pingpongx.com/qa/result.html",
  "paymentBrand": "VISA",
  "paymentType": "DEBIT",
  "relateTransactionId": "PS23080210451919493",
  "shopperResultUrl": "https://test-acquirerpay.pingpongx.com/qa/result.html",
  "sign": "F298302E076B1AEC19E3AD11B3A722C1152FEEE6981E9AB1AF55E6ACB55B9ACA",
  "signType": "SHA256",
  "status": "FAILED",
  "transactionId": "PS23080210451919493",
  "transactionTime": "1690944320000"
}

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

{
  "accId": "2023012814070510202001",
  "amount": "2.00",
  "authenticationInfo": {
    "avsResult": "Unknown",
    "cvvResult": "Y",
    "threeDSecure": "N"
  },
  "cardInfo": {
    "cardLevel": "",
    "cardType": "CREDIT",
    "firstName": "Jamesbb",
    "firstSixDigits": "444433",
    "ipCountry": "CN",
    "isoCountry": "UNITED STATES",
    "isoCountryA2": "US",
    "issuringBank": "",
    "lastFourDigits": "1111",
    "lastName": "LeBronbb",
    "paymentBrand": "VISA"
  },
  "channel": "PingPong",
  "checkoutType": "NORMAL",
  "clientId": "2023012814070510202",
  "code": "000000",
  "currency": "USD",
  "description": "Transaction succeeded",
  "language": "en",
  "merchantTransactionId": "PMT-1690943724088",
  "notificationUrl": "https://test-acquirerpay.pingpongx.com/qa/result.html",
  "paymentBrand": "VISA",
  "paymentType": "DEBIT",
  "relateTransactionId": "PS23080210364719488",
  "shopperResultUrl": "https://test-acquirerpay.pingpongx.com/qa/result.html",
  "sign": "6CADCFBC9D08BFAC4355F3659EBE8873F1C94C33A5CED6BC5FA3E561EAD485E0",
  "signType": "SHA256",
  "status": "REVIEW",
  "transactionId": "PS23080210364719488",
  "transactionTime": "1690943808000"
}

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

{
  "accId": "2018092714313010016535",
  "amount": "1.00",
  "channel": "PingPong",
  "checkoutType": "SHOPIFY",
  "clientId": "2018092714313010016",
  "code": "002000",
  "currency": "USD",
  "description": "Transaction processing",
  "language": "en",
  "merchantTransactionId": "up05lyekpqiO8u19sHi0qad4",
  "notificationUrl": "https://PingPongCheckout001.myshopify.com/payments_apps/api/2021-07/graphql.json",
  "paymentBrand": "Kakaopay",
  "paymentType": "DEBIT",
  "relateTransactionId": "PS22040818365394294",
  "shopperResultUrl": "https://PingPongCheckout001.myshopify.com",
  "sign": "AA0AED5A800B1CFCE80CC9BA87093287",
  "signType": "MD5",
  "status": "PROCESSING",
  "transactionId": "PS22040818365394294",
  "transactionTime": "1649414213000"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

{
  "channel": "PingPong",
  "code": "107001",
  "description": "Transaction failed (transaction does not exist)",
  "sign": "B5A5FC4D720A4FCBC545F9BD0275D2519B756C26F4B270E77E2811D72EC53AC3",
  "signType": "SHA256",
  "status": "FAILED"
}

1
2
3
4
5
6
7
8

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

# 交易类型

交易类型	类型描述
REFUND	退款，针对普通交易或是预授权已确认的交易进行退款操作，支持多次退款，每次退款金额<=当前剩余交易金额
CAPTURE	预授权确认，针对预授权交易进行确认操作，仅支持一次确认，确认金额<= 预授权金额
VOID	预授权取消，针对预授权交易进行取消操作，仅支持单次全额取消，取消金额 =预授权金额
APPROVE	审核通过，针对被要求人工审核的交易进行操作(普通交易在特定条件下，如⻛险交易会被标记为待审核交易，此时需要进行审核相关操作)
REJECT	审核拒绝，针对被要求人工审核的交易进行操作(普通交易在特定条件下，如⻛险交易会被标记为待审核交易，此时需要进行审核相关操作)

上次更新: 2023/08/02, 13:51:03

← 修改交易信息 3D URL查询→