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

# THB

> Sell stablecoin for Thai Baht, paid out to a first-party bank account over SWIFT rails.

THB offramp lets your users convert their stablecoin balance into Thai Baht, settled to a bank account. Every offramp flow follows the same four steps: **Create User → KYC → Bank Account Linkage → Transaction.**

> [!WARNING]
>
> **First-party payouts only:** the payout bank account must belong to the KYC-verified user. Payouts to wallets are not supported.

**1. Create User**

```http theme={null}
POST /api/v2/user
```

```json theme={null}
{
  "email": "user@example.com",
  "phone": "<phone-with-country-code>"
}
```

Response:

```json theme={null}
{
  "success": true,
  "data": {
    "user_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}
```

Save `user_id`. Every subsequent call needs it as the `X-User-Id` header.

**2. KYC**

```http theme={null}
POST /api/v2/user/kyc
```

Headers: `X-User-Id: <user_id>`

The following sender details are required for THB:

| Detail |
| - |
| `first_name` |
| `last_name` |
| `date_of_birth` |
| `nationality` |
| `mobile_number` |
| ID Type |
| Sender ID number |
| Sender ID issuing country |
| Sender ID expiry date |
| Address line |
| Town name |
| Country code |

**3. Bank Account Linkage**

```http theme={null}
POST /api/v2/user/bank_account
```

Headers: `X-User-Id: <user_id>`

The following bank account details are required for THB:

| Detail | Notes |
| - | - |
| Account Holder Name | Name on the bank account |
| Account number | Beneficiary bank account number |
| Swift/BIC Code | SWIFT / BIC code of the bank |
| Routing type | Must be `BANK_CODE` |

Save the returned `bank_id` for the sell request.

**4. Transaction**

Two variants, both requiring a quote first: a **Live Quote** (informational, executes at market rate regardless) or a **Locked Quote** (rate held \~30-60s, supplied as `quote_id` in the sell request).

> [tab] Pool Sell (recommended)
>
> Get an informational quote:
>
> ```http theme={null}
> GET /api/v2/wallet/s/quote?from_currency=USDT&to_currency=THB&from_amount=100
> ```
>
> Then create the sell:
>
> ```http theme={null}
> POST /api/v2/wallet/transaction/pool/sell
> ```
>
> ```json theme={null}
> {
>   "source_id": "<bank_id>",
>   "fiat_symbol": "THB",
>   "crypto_symbol": "USDT",
>   "crypto_amount": 25,
>   "payment_method": "bank_transfer",
>   "is_first_party": true
> }
> ```

> [tab] External Sell
>
> Generate a locked quote (expires in \~30-60s):
>
> ```http theme={null}
> GET /api/v2/wallet/w/quote?from_currency=USDT&to_currency=THB&network=BSC&from_amount=10
> ```
>
> Save `id` from the response as `quote_id`, then create the sell:
>
> ```http theme={null}
> POST /api/v2/wallet/transaction/crypto/sell
> ```
>
> ```json theme={null}
> {
>   "payment_method": "bank_transfer",
>   "network": "BSC",
>   "destination_instrument_id": "<bank_id>",
>   "quote_id": "<quote_id>",
>   "sender_wallet_address": "<sender_wallet_address>",
>   "refund_wallet_address": "<refund_wallet_address>"
> }
> ```
>
> Then fund `deposit_crypto_address` on-chain within the settlement expiry, and confirm it:
>
> ```http theme={null}
> POST /api/v2/wallet/transaction/crypto/sell/{id}/confirm-onchain-funding
> ```
>
> ```json theme={null}
> { "transaction_hash": "0x1234567890abcdef" }
> ```
>
> > [!WARNING]
> >
> > This returns **202 Accepted**, not 200. Saber verifies the deposit asynchronously.

**Payment rail:** `bank_transfer`, settled over traditional SWIFT rails. See [Payout rails and settlement](#payout-rails-and-settlement) for amount limits and processing times.

## Checking status

```http theme={null}
GET /api/v2/wallet/transaction?transaction_type={POOL_SELL|EXTERNAL_SELL}&transaction_id={id}
```

| Transaction type | Possible `status` values |
| - | - |
| Pool Sell | `CREATED`, `PROCESSING`, `COMPLETED`, `FAILED`, `CANCELLED`, `APPROVAL_REQUIRED`, `SOURCE_INVALID`, `VERIFICATION_PENDING`, `REFUND_INITIATED`, `REFUND_COMPLETED` |
| External Sell | `CREATED`, `PAYMENT_INITIATED`, `FUNDS_RECEIVED`, `COMPLETED`, `FAILED`, `REFUND_INITIATED`, `REFUND_COMPLETED`, `REFUND_FAILED` |

Poll until the status reaches a terminal state, or configure a webhook URL to receive completion pushes instead. See [Order Lifecycle and Webhooks](https://guides.saber.money/offramp/operations/lifecycle.md).

## Payout rails and settlement

| Instrument | Coverage | Limit | TAT |
| - | - | - | - |
| Bank payout | All banks | THB 700,000 | Real time |

> [!NOTE]
>
> **Only bank-account payouts are currently supported.** Payouts to wallets are not supported yet.
>
> **First-party payouts only:** the payout bank account must belong to the KYC-verified user.

## User limits and EDD

Separate user-level limits may apply. Use [Get User Limits](https://guides.saber.money/api-reference/limits/get-user-limits.md) for current user-level limits.

EDD is completed via the [EDD Hosted Widget](https://guides.saber.money/users/limits-edd/widget.md), with a turnaround time of 2-3 working days.

## Related pages

> [card] [Offramp Operations](https://guides.saber.money/offramp/available-flows.md)

> [card] [User KYC](https://guides.saber.money/user/kyc/overview.md)

> [card] [Bank Account](https://guides.saber.money/user/bank-account/overview.md)


## Related topics

- [Overview](https://guides.saber.money/offramp/overview.md)
- [Product Updates](https://guides.saber.money/changelogs.md)


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