Create a Top up
- POST /v3/b2b/order/topup
Only support USD Beneficiary AccountPrecautions:Top up to your PingPong Account balance. Now PingPong only supports USD beneficiary account top-up, and the top-up amount should not less than 100 USD.
Request Sample
curl --location --request POST 'https://test2-business-cgi.pingpongx.com/v3/b2b/order/topup' \
--header 'Authorization: Bearer a94890a8d16a4ba7b3ab64036d9624e189dd62e96aca480b91f824d0b5e0dcbe' \
--header 'Content-Type: application/json' \
--header 'timestamp: 1637564397860' \
--header 'sign: 4a70672b69b59d24d1ef05b716b1fc1d89e3e87e2b4921cb5847b6230e91c472' \
--header 'app_id: 80242303107221' \
--data-raw '{
"open_id":"MC27502480644374528",
"amount": 20.02,
"currency": "USD",
"partner_order_id": "this is a reference",
"from_account_id":"ba011911200012205085"
}'
Request Schema
| Parameter | Type | Requried | Description |
|---|---|---|---|
| open_id | String | M | User ID in PingPong |
| amount | BigDecimal | M | Amount of the charge in currency, representing how much to charge ,Minimum 100 USD |
| currency | String | M | USD |
| partner_order_id | String | M | Partner order id,using in repeat order verification |
| from_account_id | String | M | Top up account bizId which created by "Create New beneficiary Account" API |
Response Sample
{
"code": 0,
"message": "OK",
"data": {
"order_id":"1111",
"order_type":"TOPUP",
"description": "TOPUP-USD-100",
"reference":"this is a reference",
"order_amount":{
"amount":20.22,
"currency":"USD"
},
"from_account_id":"ba011911200012205085",
"created":1619681452644,
"finished":1619681452644
}
}
Response Schema
| Parameter | Type | Description |
|---|---|---|
| order_id | String | Unique ID for the charge |
| order_amount | Object | Amount of the charge in currency specified in the request |
| order_amount.amount | BigDecimal | Charge amount |
| order_amount.currency | String | USD |
| description | String | Descriptive information about the order |
| reference | String | User specified reference that will be displayed to the beneficiary specified in the request |
| order_type | String | TOPUP |
| from_account_id | String | Recharge bank account id |
| created | Long | The time of charge created |
| finished | Long | Order completion time |
Support Currency
| Currency | Support Location |
|---|---|
| USD | Except this location: HAWAII,NEVADA,NEW JERSEY,NEW YORK |
| EUR、GBP(Will support in the near future) | All |