Withdrawal/Send to Recipient/PingPong Account

• POST /v3/b2b/order/payout

• Precautions: A payment order is created when you send funds to a beneficiary, recipient’s bank account or PingPong account.

You can create the payment order by using the “lock_rate_id” which was previously created by calling "Query Fee and Fx Rate for Payment" API.

Payment includes the following order types:

WITHDRAW: Submit a request to withdraw to the user’s bank account from an available balance of a PingPong Account.

RECIPIENT: Submit a request to initiate a payment to a bank account from an available balance of a PingPong Account. If the recipient does not have a PingPong Account, user can send a payment via bank transfer.

TRANSFER: Submit a request to initiate a payment to an existing PingPong Account from an available balance of a PingPong Account.

EXCHANGE: Submit a request to change one currency to another from an available balance of a PingPong Account.

Request Sample

curl --location --request POST 'https://test2-business-cgi.pingpongx.com/v3/b2b/order/payout' \
--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":5.1,
      "origin_currency":"USD",
      "target_currency":"THB",
      "order_type":"WITHDRAW",
      "rate_id":"123",
      "partner_order_id":"123",
      "reference":"this is a withdraw order",
      "from_account_id":"ba011911200012205085",
      "to_account_id":"ba011911200012205085",
      "cal_rule":"TARGET2ORIGIN"
}'

Request Schema

partner_transactions

Response Sample

{
    "code":0,
    "message":"OK",
    "data":{
        "order_id":"W02202101061300335539414",
        "partner_order_id":"443",
        "description":"Withdraw-Account1-100USD",
        "reference":"this is reference",
        "order_type":"WITHDRAW",
        "from_account_id":"ba011911200012205085",
        "to_account_id":"ba011911200012205085",
        "created":1619681452644,
        "finished":1619681452644,
        "fee":{
            "amount":1,
            "currency":"USD"
        },
        "fx":{
            "rate_id":"43",
            "rate":6.5,
            "origin_currency":"USD",
            "target_currency":"THB"
        },
        "order_amount":{
              "amount":20.22,
              "currency":"USD"
        },
        "detail":{
          "target_amount":5.1,
          "target_currency":"THB"
        }
    }
}

Response Schema