---
title: "Swap Fiat Currency"
method: POST
path: "/payments/swap-currency"
tags: ["Payments"]
---

# Swap Fiat Currency

`POST /payments/swap-currency`

Swap fiat balance between NGN and GHS in either direction. The `from` and `to` currencies must be different.

## Request body

- object
  - `amount` number, required — Amount in the `from` currency to swap.
  - `from` 'ngn' | 'ghs', required — Currency to swap from. Must differ from `to`.
  - `to` 'ngn' | 'ghs', required — Currency to swap into. Must differ from `from`.
  - `pin` string, required — Transaction PIN.

## Response `200`

Swap completed successfully

## Other responses

- `400` — Bad request (e.g. insufficient balance, same currency)
- `401` — Invalid or missing API credentials
- `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)