单笔交易查询

请求地址

https://{host}/v2/query

请求参数

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

响应参数

参数字段	参数属性	参数说明
clientId	M	PingPong 商户商户号
accId	M	PingPong
transactionId	M	PingPong 交易流水号
merchantTransactionId	M	商户网站的的交易流水号
code	M	结果状态码
description	M	结果描述
paymentType	M	交易类型: SALE-直接付款 AUTH-预授权 REFUND-退款 CAPTURE-预授权确认 VOID-预授权取消 APPROVE-审核通过 REJECT-审核拒绝
currency	M	交易币种
amount	M	交易金额
transactionTime	M	交易发起时间，yyyyMMddHHmmss
completeTime	M	交易处理完成时间，yyyyMMddHHmmss
status	M	SUCCESS-成功 FAILED-失败 PROCESSING-进行中 REVIEW-待审核
signType	M	签名规约，支持 MD5、SHA256，具体⻅本文“签名 方案”一栏
sign	M	签名内容，具体⻅本文“签名规约”一栏
remark	C	商户扩展字段
threeDSecure	C	3DS 交易标示 Y/N

响应报文示例

{
	"accId": "2018092714313010016291",
	"amount": "1.08",
	"channel": "PingPong",
	"checkoutType": "NORMAL",
	"clientId": "2018092714313010016",
	"code": "000000",
	"currency": "USD",
	"description": "Transaction succeeded",
	"language": "en",
	"merchantTransactionId": "PShop20220413170411VA",
	"notificationUrl": "https://test-pay.pingpongx.com/qa/notify",
	"paymentBrand": "VISA",
	"paymentType": "SALE",
	"relateTransactionId": "PS22041317045194485",
	"shopperResultUrl": "https://test-pay.pingpongx.com/qa/result.html",
	"sign": "36B157B690BDAFAD007CAD162DB87133",
	"signType": "MD5",
	"status": "SUCCESS",
	"transactionId": "PS22041317045194485",
	"transactionTime": "1649840693000"
}

{
	"accId": "2018092714313010016289",
	"amount": "1.08",
	"channel": "PingPong",
	"checkoutType": "",
	"clientId": "2018092714313010016",
	"code": "301002",
	"currency": "USD",
	"description": "Transaction declined (Do not honor,Please contact the issuing bank to confirm the bank card payment limit))",
	"language": "en",
	"merchantTransactionId": "PShop20220414111515LN",
	"notificationUrl": "https://test-pay.pingpongx.com/qa/notify",
	"paymentBrand": "Mastercard",
	"paymentType": "SALE",
	"relateTransactionId": "PS22041411151594559",
	"shopperResultUrl": "https://test-pay.pingpongx.com/qa/result.html",
	"sign": "7762D18FE89F24E6F07C231E1B2E96E0",
	"signType": "MD5",
	"status": "FAILED",
	"transactionId": "PS22041411151594559",
	"transactionTime": "1649906117000"
}

{
	"accId": "2018092714313010016289",
	"amount": "2.00",
	"channel": "PingPong",
	"checkoutType": "SHOPIFY",
	"clientId": "2018092714313010016",
	"code": "000000",
	"currency": "USD",
	"description": "Transaction succeeded",
	"language": "en",
	"merchantTransactionId": "24863450071207",
	"notificationUrl": "https://beste-productsmall.myshopify.com/services/ping/notify_integration/pingpongpaydev/44812107943",
	"paymentBrand": "VISA",
	"paymentType": "SALE",
	"relateTransactionId": "PS22010417162385131",
	"shopperResultUrl": "https://beste-productsmall.com/44812107943/checkouts/15c1ef6485bcacae405d95306f5c68c5/offsite_gateway_callback",
	"sign": "E8C420883A46A0AF91ECA6296B86AA77",
	"signType": "MD5",
	"status": "REVIEW",
	"transactionId": "PS22010417162385131",
	"transactionTime": "1641287788000"
}

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

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

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

交易类型

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