> ## 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.

# Seamless wallet

> The APIs you provide for us to call, and the rules to follow, when you use the seamless wallet.

With the seamless wallet, you manage the member's balance. We call the APIs you provide to check the balance, place bets, settle bets and cancel bets.

## Requests

* Request URL: the URL `{partnerHost}` you provide for calling your services.
* Request example: `{partnerHost}/v1.0/transaction/balance`
* Response format: always `application/json`.

> [!NOTE]
>
> `{partnerHost}` is the domain provided by the seamless wallet integrator, who hosts these services.

## Rules

* Add our IPs to your allowlist and block all other IPs.
* On every request, verify that the `Authorization` header contains our token, and reject any other token.
* On every request, verify the `sign` parameter. `sign` is generated from the data sent plus the API key; see [Signature](https://doc.va777.net/en/v1/guides/signature.md).
* Always return HTTP status `200`, and **include both `data` and `status` in every response**: `data` is the response content and `status` is the processing status of the request.

## Response format

**data** `object` *required*

Response content. See each API for its response data.

**status** `object` *required*

Response status.

**Properties**

**code** `string` *required*

Response code. See [Response codes](https://doc.va777.net/en/v1/reference/response-codes.md).

**message** `string` *required*

Response message describing the result of the request.

**datetime** `string` *required*

Time the request was received, in RFC3339.

**traceCode** `string` *required*

Unique trace code for matching responses on both sides.

## APIs you provide

> [card] [Check member balance](https://doc.va777.net/en/v1/api-reference/partner/transaction/balance.md)
>
> `GET {partnerHost}/v1.0/transaction/balance`

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

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

> [card] [Cancel bet](https://doc.va777.net/en/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.