---
title: "Withdraw BTC"
method: POST
path: "/withdraw/btc"
tags: ["Withdraw"]
---

# Withdraw BTC

`POST /withdraw/btc`

Withdraw BTC to a wallet

## Request body

- object
  - `invoice` string, string
  - `memo` string, string

## Response `200`

Withdraw response

- object
  - `status` string, string
  - `data` Transaction
    - `id` string, uuid — The unique identifier for the transaction
    - `walletId` string, uuid — The unique identifier for the wallet
    - `ref` string, string — The reference for the transaction
    - `hash` string, string — The payment hash for the lightning invoice attached to the quote related to the transaction
    - `amount` number — The amount of the transaction in its lowest denomination
    - `fees` number — The fees for the transaction in its lowest denomination
    - `currency` 'NGN' | 'KES' | 'BTC' | 'ZAR' | 'GHS' | 'USDT', string — The currency of the transaction
    - `type` 'WITHDRAWAL' | 'DEPOSIT', string — The type of the transaction
    - `status` 'SUCCESS' | 'PENDING' | 'FAILED', string — The status of the transaction
    - `autopayout` boolean — Whether the transaction is an instant payout
    - `createdAt` string, date-time — The date and time the transaction was created
    - `updatedAt` string, date-time — The date and time the transaction was last updated
    - `metadata` TransactionMetadata
      - `id` string, uuid
      - `orderId` string, string
      - `bankCode` string, string
      - `bankAccountName` string, string
      - `bankAccountNumber` string, string
      - `customerInternalFee` number
      - `createdAt` string, date-time
      - `updatedAt` string, date-time

## Other responses

- `400` — Unexpected error

## Changes

- **2026-08-20** `842376cab855` — 1 warning
  - added the new `USDT` enum value to the `data/currency` response property for the response status `200`
- **2026-04-01** `b1804285e901` — 1 warning
  - added the new `GHS` enum value to the `data/currency` response property for the response status `200`
- **2025-02-25** `f3878f349317` — 1 info
  - removed the `TRANSFER` enum value from the `data/type` response property for the response status `200`
- **2025-02-01** `7b7e4fa5fe46` — 1 warning, 1 info
  - removed the optional property `data/transactionMetadata` from the response with the `200` status
  - added the optional property `data/metadata` to the response with the `200` status
- **2025-02-01** `c220a3435512` — 2 warning, 1 info
  - removed the optional property `data/transactionMetadata/eProviderRef` from the response with the `200` status
  - added the new `ZAR` enum value to the `data/currency` response property for the response status `200`
  - removed the `USD` enum value from the `data/currency` response property for the response status `200`

[Full history](https://skmtc.dev/stealthmoney/apis/mavapay-api/changes/withdraw/btc/post.md)

---

[API](https://skmtc.dev/stealthmoney/apis/mavapay-api.md) · [All operations](https://skmtc.dev/stealthmoney/apis/mavapay-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stealthmoney/mavapay-api/revisions/842376cab855/schema)