Query list of transactions
• POST /v3/b2b/financial/transactions
Precautions: Use this API to query the history of transactions that contributed to the PingPong account balance. By using the optional filters like query type, order type and time interval you can search specified results. Results can be paginated, with maximum list limit of 200 results.
Request Sample
curl --location --request POST 'https://test2-business-cgi.pingpongx.com/v3/b2b/financial/transactions' \
--header 'Authorization: Bearer a94890a8d16a4ba7b3ab64036d9624e189dd62e96aca480b91f824d0b5e0dcbe' \
--header 'Content-Type: application/json' \
--header 'timestamp: 1637564397860' \
--header 'sign: 4a70672b69b59d24d1ef05b716b1fc1d89e3e87e2b4921cb5847b6230e91c472' \
--header 'app_id: 80242303107221' \
--data-raw '{
"open_id":"MC27502480644374528",
"order_id":"W02202101061300335539414",
"query_type":"INBOUND_ORDER",
"page_no":1,
"page_size":100,
"start_time":1619677211,
"end_time":1619677211
}'
Request Schema
| Parameter | Type | Requried | Description |
|---|---|---|---|
| open_id | String | M | User Id in PingPong |
| order_id | String | O | Order Id |
| partner_order_id | String | O | PartnerOrderId Id |
| query_type | String | O | INBOUND_ORDER,OUTBOUND_ORDER,is empty query all |
| order_type | String | O | One of these order type TOPUP,WITHDRAW,RECIPIENT,TRANSFER,EXCHANGE,RECEIVE,REFUND,REFUND FEE |
| page_no | number | M | The page number |
| page_size | number | M | The page of size,upper limit 200 |
| start_time | Long | O | The start time |
| end_time | Long | O | The end time |
Reponse Sample
{
"code": 0,
"message": "OK",
"data" : {
"total": 150,
"pages": 2,
"page_no": 1,
"page_size": 100,
"records": [
{
"order_id":"W02202101061300335539414",
"order_type":"WITHDRAW",
"status":"SUCCESS",
"description":"XXXX1",
"reference":"XXXX1",
"from_account_id":"ba011911200012205085",
"to_account_id":"ba011911200012205085",
"fx_rate":"2.333",
"order_amount":{
"amount":20.22,
"currency":"USD"
},
"fee":{
"amount":654,
"currency":"CHY"
},
"detail":{
"target_amount":654,
"target_currency":"CHY"
},
"create_time":1619681452644,
"finish_time":1619681452644
}
]
}
}
Response Schema
| Parameter | Type | Description |
|---|---|---|
| total | Integer | Total Records |
| pages | Integer | Totol number of page |
| page_no | Integer | Current page number |
| page_size | Integer | Number of results per page |
| records | List | List of orderDetail |
| order_id | String | Order ID |
| partner_order_id | String | partner_order_id |
| partner_transaction_infos | List | Partner transaction list |
| status | String | Order status SUCCESS、FAIL、PENDING |
| reference | String | User specified reference that will be displayed to the beneficiary specified in the request |
| description | String | Description |
| order_type | String | Order of type TOPUP,WITHDRAW,RECIPIENT,TRANSFER,EXCHANGE,RECEIVE,REFUND,REFUND FEE |
| from_account_id | String | If you want to pay from your local Bank Account,it`s required(bizId of "Create new Beneficiary Account" API) |
| to_account_id | String | Recipient account bizId |
| create_time | Long | The time this charge was created |
| finish_time | Long | Accounting completion time |
| fee | Object | Service Charge |
| fee.amount | String | Fee Amount |
| fee.currency | String | Fee currency,same with origin currency |
| fx_rate | BigDecimal | Exchange Rate |
| order_amount | Object | |
| order_amount.amount | BigDecimal | PingPong Account deduction amount |
| order_amount.currency | String | Order Currency |
| detail | Object | |
| detail.target_amount | BigDecimal | Amount Received |
| detail.target_currency | String | Currency of Receipt |
partner_transaction_infos
| Parameter | Type | Description |
|---|---|---|
| order_id | String | Partner order id,using in repeat order verification |
| order_time | String | Partner order id,using in repeat order verification |
| amount | String | Partner order id,using in repeat order verification |
| currency | String | Partner order id,using in repeat order verification |
| description | String | Partner order id,using in repeat order verification |
| shipping_tracking_number | String | Partner order id,using in repeat order verification |