取款 - VA 遊戲 API

取款

curl --request POST \
  --url https://your-api-host/vendor/v2.0/transaction/withdraw \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "transactionID": "<string>",
  "channelID": 123,
  "account": "<string>",
  "currency": "<string>",
  "amount": 123,
  "sign": "<string>"
}
'

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://your-api-host/vendor/v2.0/transaction/withdraw",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'transactionID' => '<string>',
    'channelID' => 123,
    'account' => '<string>',
    'currency' => '<string>',
    'amount' => 123,
    'sign' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    transactionID: '<string>',
    channelID: 123,
    account: '<string>',
    currency: '<string>',
    amount: 123,
    sign: '<string>'
  })
};

fetch('https://your-api-host/vendor/v2.0/transaction/withdraw', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://your-api-host/vendor/v2.0/transaction/withdraw"

payload = {
    "transactionID": "<string>",
    "channelID": 123,
    "account": "<string>",
    "currency": "<string>",
    "amount": 123,
    "sign": "<string>"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "data": {
    "transactionID": "withdraw-hereIsYourTransId",
    "channelID": 1,
    "account": "player001",
    "amount": 10.0,
    "currency": "CNY",
    "balanceBefore": 30.0,
    "balanceAfter": 20.0
  },
  "status": {
    "code": "0",
    "message": "success",
    "datetime": "2022-07-04T23:13:54.920+08:00",
    "traceCode": "7cf25e1957cc47fe8e01f1a7c6d504d6"
  }
}

POST

vendor

v2.0

transaction

withdraw

取款

curl --request POST \
  --url https://your-api-host/vendor/v2.0/transaction/withdraw \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "transactionID": "<string>",
  "channelID": 123,
  "account": "<string>",
  "currency": "<string>",
  "amount": 123,
  "sign": "<string>"
}
'

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://your-api-host/vendor/v2.0/transaction/withdraw",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'transactionID' => '<string>',
    'channelID' => 123,
    'account' => '<string>',
    'currency' => '<string>',
    'amount' => 123,
    'sign' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    transactionID: '<string>',
    channelID: 123,
    account: '<string>',
    currency: '<string>',
    amount: 123,
    sign: '<string>'
  })
};

fetch('https://your-api-host/vendor/v2.0/transaction/withdraw', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://your-api-host/vendor/v2.0/transaction/withdraw"

payload = {
    "transactionID": "<string>",
    "channelID": 123,
    "account": "<string>",
    "currency": "<string>",
    "amount": 123,
    "sign": "<string>"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "data": {
    "transactionID": "withdraw-hereIsYourTransId",
    "channelID": 1,
    "account": "player001",
    "amount": 10.0,
    "currency": "CNY",
    "balanceBefore": 30.0,
    "balanceAfter": 20.0
  },
  "status": {
    "code": "0",
    "message": "success",
    "datetime": "2022-07-04T23:13:54.920+08:00",
    "traceCode": "7cf25e1957cc47fe8e01f1a7c6d504d6"
  }
}

僅部份遊戲支援會員在線時取款。
回應資訊包含取款前後的錢包餘額。
單次取款金額上限為 99,999,999,999.99。
若需單次取款超過上限，請通知我方客服。
取款交易代碼應有withdraw-前綴。

請求參數

string

必填

參與簽章

交易代碼 (需為唯一值)

number

必填

參與簽章

渠道編號 (若無渠道，請帶入1)

string

必填

參與簽章

會員帳號 (允許字元:a-z A-Z 0-9 _-)

string

必填

參與簽章

幣別 (請洽詢我方商務)

number

必填

參與簽章

轉帳金額 (允許小數點後兩位)

string

必填

簽章，產生方式請參考簽章規則

回應

成功（HTTP 狀態碼固定為 200，請以 status.code 判斷結果）

object

顯示屬性

string

交易代碼

number

渠道編號

string

會員帳號

number

轉帳金額

string

幣別 (請洽詢我方商務)

number

轉帳前錢包餘額

number

轉帳後錢包餘額

object

每次回應都會附帶的請求處理狀態

顯示屬性

string

回應訊息碼，請參照回應訊息碼

string

回應詳細訊息

string

請求接收時間，格式為 RFC3339

string

回應追蹤碼（唯一值），供雙方比對回應內容

{
  "data": {
    "transactionID": "withdraw-hereIsYourTransId",
    "channelID": 1,
    "account": "player001",
    "amount": 10.0,
    "currency": "CNY",
    "balanceBefore": 30.0,
    "balanceAfter": 20.0
  },
  "status": {
    "code": "0",
    "message": "success",
    "datetime": "2022-07-04T23:13:54.920+08:00",
    "traceCode": "7cf25e1957cc47fe8e01f1a7c6d504d6"
  }
}

會員

遊戲

錢包

注單

帳務與服務檢查

免費旋轉

取款

請求參數

回應

​請求參數

​回應

請求參數

回應