> ## Documentation Index
> Fetch the complete documentation index at: https://doc.va777.net/llms.txt
> Use this file to discover all available pages before exploring further.

# 單錢包服務

> 採用單錢包時，貴司需提供給我方呼叫的 API 規格與注意事項。

採用單錢包時，會員餘額由貴司管理。我方會在查詢餘額、下注、派彩與取消注單時呼叫貴司提供的 API。

## 請求方式

* 請求網址：由貴司提供用於呼叫貴司服務的網址 `{partnerHost}`。
* 請求範例：`{partnerHost}/v1.0/transaction/balance`
* 回應格式：皆為 `application/json`。

> [!NOTE]
>
> `{partnerHost}` 為單錢包介接方提供的網域，由介接方提供服務。

## 注意事項

* 須將我方 IP 加入貴司白名單，非我方 IP 須禁止存取。
* 每個請求都須驗證 Header 中的 `Authorization` 為我方令牌，非我方令牌須禁止存取。
* 每個請求都必須驗證 `sign` 參數。`sign` 由傳遞的資料與 API Key 產生，請參考[簽章規則](https://doc.va777.net/zh-Hant/v1/guides/signature.md)。
* HTTP 狀態碼須固定為 `200`，且**每次回應都須包含 `data` 與 `status`**：`data` 為此次請求的回應內容，`status` 為此次請求的處理狀態。

## 回應格式

**data** `object` *required*

回應內容，請參照各 API 的回應資料。

**status** `object` *required*

回應狀態。

**屬性**

**code** `string` *required*

回應訊息碼，請參考[回應訊息碼](https://doc.va777.net/zh-Hant/v1/reference/response-codes.md)。

**message** `string` *required*

回應詳細訊息，為此次請求的回應狀況。

**datetime** `string` *required*

回應時間，記錄此次請求的接收時間，格式為 RFC3339。

**traceCode** `string` *required*

回應追蹤碼，為唯一值，方便雙方比對回應內容。

## 貴司需提供的 API

> [card] [確認會員餘額](https://doc.va777.net/zh-Hant/v1/api-reference/partner/transaction/balance.md)
>
> `GET {partnerHost}/v1.0/transaction/balance`

> [card] [下注](https://doc.va777.net/zh-Hant/v1/api-reference/partner/transaction/place-bet.md)
>
> `POST {partnerHost}/v1.0/transaction/placeBet`

> [card] [派彩](https://doc.va777.net/zh-Hant/v1/api-reference/partner/transaction/settle-bet.md)
>
> `POST {partnerHost}/v1.0/transaction/settleBet`

> [card] [取消注單](https://doc.va777.net/zh-Hant/v1/api-reference/partner/transaction/cancel-bet.md)
>
> `POST {partnerHost}/1.0/transaction/cancelBet`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.