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

# Supported Currencies

> Complete list of supported fiat currencies, countries, and delivery channels

Paycrest supports fiat currencies across multiple countries and regions, with delivery channels including bank transfers and mobile payments. New corridors launch only when committed liquidity providers are onboarded and tested.

## Active Corridors

| Country      | Flag | Currency           | Code | Channels     |
| ------------ | ---- | ------------------ | ---- | ------------ |
| **Nigeria**  | 🇳🇬 | Nigerian Naira     | NGN  | Bank, Mobile |
| **Kenya**    | 🇰🇪 | Kenyan Shilling    | KES  | Bank, Mobile |
| **Uganda**   | 🇺🇬 | Ugandan Shilling   | UGX  | Bank, Mobile |
| **Tanzania** | 🇹🇿 | Tanzanian Shilling | TZS  | Bank, Mobile |
| **Malawi**   | 🇲🇼 | Malawi Kwacha      | MWK  | Bank, Mobile |
| **Brazil**   | 🇧🇷 | Brazilian Real     | BRL  | Mobile (PIX) |

## Delivery Channel Matrix

| Currency | Bank Transfer | Mobile / Wallet |
| -------- | ------------- | --------------- |
| **NGN**  | ✅             | ✅               |
| **KES**  | ✅             | ✅               |
| **UGX**  | ✅             | ✅               |
| **TZS**  | ✅             | ✅               |
| **MWK**  | ✅             | ✅               |
| **BRL**  | ❌             | ✅ (PIX)         |

## Integration Examples

### Bank Transfer (Nigeria)

```javascript theme={null}
const order = {
  amount: "100",
  source: {
    type: "crypto",
    currency: "USDT",
    network: "base",
    refundAddress: "0xYourAddress"
  },
  destination: {
    type: "fiat",
    currency: "NGN",
    recipient: {
      institution: "GTBINGLA",
      accountIdentifier: "1234567890",
      accountName: "John Doe",
      memo: "Salary payment"
    }
  }
};
```

### Mobile Money (Kenya)

Phone M-Pesa, **Till** (buy goods), and **Paybill** all use a KES mobile institution (typically **`SAFAKEPC`**). Set **`destination.recipient.metadata.channel`** to **`Mobile`**, **`Till`**, or **`Paybill`**. Full rules and KYC notes are in **[Sender API Integration — KES mobile money](/implementation-guides/sender-api-integration#kes-mobile-money-m-pesa-till-paybill)**.

**Phone M-Pesa**

```javascript theme={null}
const order = {
  amount: "50",
  source: {
    type: "crypto",
    currency: "USDC",
    network: "base",
    refundAddress: "0xYourAddress"
  },
  destination: {
    type: "fiat",
    currency: "KES",
    recipient: {
      institution: "SAFAKEPC",
      // Local (07…) or international (254…) MSISDN; API normalizes on create and verify-account
      accountIdentifier: "0712345678",
      accountName: "Jane Smith",
      memo: "Mobile payment",
      metadata: { channel: "Mobile" }
    }
  }
};
```

**Till**

```javascript theme={null}
recipient: {
  institution: "SAFAKEPC",
  accountIdentifier: "123456",
  accountName: "Shop Name",
  memo: "Payment",
  metadata: { channel: "Till" }
}
```

**Paybill**

```javascript theme={null}
recipient: {
  institution: "SAFAKEPC",
  accountIdentifier: "INV-001",
  accountName: "Customer",
  memo: "Bill pay",
  metadata: { channel: "Paybill", businessNumber: "400200" }
}
```

### PIX (Brazil)

```javascript theme={null}
const order = {
  amount: "200",
  source: {
    type: "crypto",
    currency: "USDT",
    network: "arbitrum-one",
    refundAddress: "0xYourAddress"
  },
  destination: {
    type: "fiat",
    currency: "BRL",
    recipient: {
      institution: "PIXKBRPC",
      accountIdentifier: "johndoe@email.com",
      accountName: "João Silva",
      memo: "PIX payment"
    }
  }
};
```

## Rate Information

Exchange rates are dynamic and depend on:

* **Market conditions**: Real-time forex rates
* **Provider competition**: Multiple providers competing per corridor
* **Transaction volume**: Higher volumes may get better rates

Use the [GET /rates](/api-reference/general/get-token-rate) endpoint to fetch the current achievable rate before creating an order.

<Note>
  All supported currencies are actively monitored for compliance and regulatory requirements. Delivery times and fees may vary by provider and region.
</Note>

## API Endpoints

* **[GET /currencies](/api-reference/general/list-supported-currencies)** — Get all supported fiat currencies with current market rates
* **[GET /institutions/{currency}](/api-reference/general/list-supported-institutions)** — Get supported banks and mobile payment providers for a specific currency

<Note>
  Currency codes follow the [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) standard. Institution codes use SWIFT codes (first 7 characters) for international banks, or custom codes ending with `PC` for local institutions. See **[Code Standards](/resources/code-standards)** for details.
</Note>