---
title: "Convert Fiat to USD"
method: POST
path: "/payments/fiat-to-usd"
tags: ["Conversion"]
---

# Convert Fiat to USD

`POST /payments/fiat-to-usd`

Convert local fiat (NGN or GHS) balance to USD. Optionally provide a withdrawal address ID to automatically withdraw the converted USD to that address.

## Request body

- object
  - `amount` number, required — Amount in local fiat (NGN or GHS) to convert to USD.
  - `pin` string — Transaction PIN (required when withdrawalAddressId is provided).
  - `withdrawalAddressId` string — ID of a saved withdrawal address. If provided, the converted USD is withdrawn to this address; PIN is required.

## Response `200`

Conversion (and optional withdrawal) completed successfully

## Other responses

- `400` — Bad request (e.g. duplicate, invalid amount)
- `401` — Invalid or missing API credentials
- `403` — Conversion disabled or insufficient balance
- `404` — Withdrawal address not found
- `422` — Request validation failed — check the errors array for field-level details
- `500` — An unexpected server error occurred

---

[API](https://skmtc.net/breet/apis/breet-public-api.md) · [All operations](https://skmtc.net/breet/apis/breet-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/breet/breet-public-api/revisions/5e7cf25847f7/schema)
