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

# Documentation

> Multi-currency wallet management platform, transfers, and transactions.

## About

Cartevo's documentation provides a complete technical guide for developers who want to integrate the multi-currency wallet management platform into their applications.

Cartevo allows businesses to:

* Manage wallets (creation, details, balance)
* Fund wallets (local funding, deposit with exchange, test credit in pre-production)
* Perform transfers (internal and between wallets)
* View transactions (by wallet, client, status)
* Manage clients (creation, list, details)

### Supported Countries in Africa

Cartevo supports multiple African countries with local currency and mobile money integration:

<AccordionGroup>
  <Accordion title="Burkina Faso 🇧🇫">
    | Operator         | Correspondent | OTP Required | Country Currency | Decimals in amount |
    | ---------------- | ------------- | ------------ | ---------------- | ------------------ |
    | Moov Money       | moov          | No           | XOF              | NO                 |
    | Orange Money     | orange        | Yes          | XOF              | NO                 |
    | Wallet LigdiCash | wligdicash    | Yes          | XOF              | NO                 |
  </Accordion>

  {" "}

  <Accordion title="DRC 🇨🇩">
    | Operator     | Correspondent | OTP Required | Country Currency | Decimals in amount |
    | ------------ | ------------- | ------------ | ---------------- | ------------------ |
    | Airtel Money | airtel        | No           | CDF              | YES                |
    | Mpesa Money  | mpesa         | No           | CDF              | YES                |
    | Orange Money | orange        | No           | CDF              | YES                |
    | Afri Money   | afrimoney     | No           | CDF              | YES                |
  </Accordion>

  {" "}

  <Accordion title="Congo Brazzaville 🇨🇬">
    | Operator     | Correspondent | OTP Required | Country Currency | Decimals in Amount |
    | ------------ | ------------- | ------------ | ---------------- | ------------------ |
    | Airtel Money | airtel        | No           | XAF              | No                 |
    | MTN Money    | mtn           | No           | XAF              | No                 |
  </Accordion>

  {" "}

  <Accordion title="Tchad 🇹🇩">
    | Operator     | Correspondent | OTP Required | Country Currency | Decimals in Amount |
    | ------------ | ------------- | ------------ | ---------------- | ------------------ |
    | Airtel Money | airtel        | No           | XAF              | No                 |
    | Moov Money   | moov          | No           | XAF              | No                 |
  </Accordion>

  {" "}

  <Accordion title="Guinea-Bissau 🇬🇼">
    | Operator     | Correspondent | OTP Required | Country Currency | Decimals in Amount |
    | ------------ | ------------- | ------------ | ---------------- | ------------------ |
    | Orange Money | orange        | No           | XOF              | No                 |
  </Accordion>

  {" "}

  <Accordion title="Gambia 🇬🇲">
    | Operator   | Correspondent | OTP Required | Country Currency | Decimals in Amount |
    | ---------- | ------------- | ------------ | ---------------- | ------------------ |
    | Afri Money | afrimoney     | No           | GMD              | No                 |
  </Accordion>

  {" "}

  <Accordion title="Côte d'Ivoire 🇨🇮">
    | Operator     | Correspondent | OTP Required | Country Currency | Decimals in amount |
    | ------------ | ------------- | ------------ | ---------------- | ------------------ |
    | Moov Money   | moov          | No           | XOF              | NO                 |
    | MTN Money    | mtn           | No           | XOF              | NO                 |
    | Orange Money | orange        | Yes          | XOF              | NO                 |
    | Wave Money   | wave          | No           | XOF              | NO                 |
  </Accordion>

  {" "}

  <Accordion title="Cameroon 🇨🇲">
    | Operator     | Correspondent | OTP Required | Country Currency | Decimals in amount |
    | ------------ | ------------- | ------------ | ---------------- | ------------------ |
    | MTN Money    | mtn           | No           | XAF              | NO                 |
    | Orange Money | orange        | No           | XAF              | NO                 |
  </Accordion>

  {" "}

  <Accordion title="Gabon 🇬🇦">
    | Operator     | Correspondent | OTP Required | Country Currency | Decimals in amount |
    | ------------ | ------------- | ------------ | ---------------- | ------------------ |
    | Airtel Money | airtel        | No           | XAF              | NO                 |
    | Moov Money   | moov          | No           | XAF              | NO                 |
  </Accordion>

  {" "}

  <Accordion title="Guinea Conakry 🇬🇳">
    | Operator     | Correspondent | OTP Required | Country Currency | Decimals in amount |
    | ------------ | ------------- | ------------ | ---------------- | ------------------ |
    | MTN Money    | mtn           | No           | GNF              | NO                 |
    | Orange Money | orange        | No           | GNF              | NO                 |
  </Accordion>

  {" "}

  <Accordion title="Mali 🇲🇱">
    | Operator     | Correspondent | OTP Required | Country Currency | Decimals in amount |
    | ------------ | ------------- | ------------ | ---------------- | ------------------ |
    | Moov Money   | moov          | No           | XOF              | NO                 |
    | Orange Money | orange        | No           | XOF              | NO                 |
  </Accordion>

  {" "}

  <Accordion title="Niger 🇳🇪">
    | Operator     | Correspondent | OTP Required | Country Currency | Decimals in amount |
    | ------------ | ------------- | ------------ | ---------------- | ------------------ |
    | Airtel Money | airtel        | No           | XOF              | NO                 |
  </Accordion>

  {" "}

  <Accordion title="Senegal 🇸🇳">
    | Operator     | Correspondent | OTP Required | Country Currency | Decimals in amount |
    | ------------ | ------------- | ------------ | ---------------- | ------------------ |
    | E-money      | expresso      | No           | XOF              | NO                 |
    | Free Money   | free          | No           | XOF              | NO                 |
    | Orange Money | orange        | Yes          | XOF              | NO                 |
    | Wave Money   | wave          | No           | XOF              | NO                 |
  </Accordion>

  {" "}

  <Accordion title="Togo 🇹🇬">
    | Operator   | Correspondent | OTP Required | Country Currency | Decimals in amount |
    | ---------- | ------------- | ------------ | ---------------- | ------------------ |
    | Moov Money | moov          | No           | XOF              | NO                 |
    | T-Money    | tmoney        | No           | XOF              | NO                 |
  </Accordion>

  {" "}

  <Accordion title="Benin 🇧🇯">
    | Operator      | Correspondent | OTP Required | Country Currency | Decimals in amount |
    | ------------- | ------------- | ------------ | ---------------- | ------------------ |
    | Moov Money    | moov          | No           | XOF              | NO                 |
    | MTN Money     | mtn           | No           | XOF              | NO                 |
    | Celtiis Money | celtiis       | No           | XOF              | NO                 |
    | Coris Money   | coris         | No           | XOF              | NO                 |
  </Accordion>

  {" "}

  <Accordion title="Central African Republic 🇨🇫">
    | Operator     | Correspondent | OTP Required | Country Currency | Decimals in Amount |
    | ------------ | ------------- | ------------ | ---------------- | ------------------ |
    | Orange Money | orange        | No           | XAF              | No                 |
    | Telecel      | telecel       | No           | XAF              | No                 |
  </Accordion>

  {" "}
</AccordionGroup>

> 💡**Note** : For API integration into your application, the value used to select the operator corresponds to the entry listed in the "**Correspondent**" column of the operators table. This value must be passed in requests so that the API correctly identifies the operator to be used for the intended transaction or operation.

## Getting Started

To begin using Cartevo's services:

<Steps>
  <Step title="Create an Account">
    Visit [Cartevo's website](https://cartevo.co) and click "Sign Up" - Complete
    the registration form with your details - Accept the terms and conditions
  </Step>

  <Step title="Verify Your Account">
    Check your email for the verification link - Click the link to verify your
    email address - Complete any required KYC (Know Your Customer) and KYB (Know
    Your Business) verification process
  </Step>

  <Step title="Generate API Key">
    Log in to your verified account - Navigate to the Developer Dashboard - Go
    to the "API Settings" section - Generate a new API key - Copy and securely
    store your API credentials
  </Step>

  <Step title="Start Integration">
    Refer to our [API documentation](/) for implementation details - Use your
    API key to authenticate requests - Begin testing with our pre-production
    environment before going live
  </Step>
</Steps>

### Key Capabilities

* Multi-currency creation: XAF, XOF, USD, …
* Operation encoding: idempotency, pagination, filters by status/type
* Security: Bearer authentication, pre-production/production separation

#### \* Pricing for Cartvo for our business partners:

| Action          | Cost                                                               |
| --------------- | ------------------------------------------------------------------ |
| card creation   | \$1                                                                |
| Card Top-up     | \$0                                                                |
| Card withdrawal | \$0                                                                |
| Cross-border    | \$0.5 + 2.5% fee applies for payments made to shops outside the US |
| Payment failure | \$0.5                                                              |
| Chargeback      | Flat rate of \$60                                                  |

## Quick Start

<Card title="Quickstart Guide" icon="rocket" href="/quickstart" horizontal>
  Quickly integrate essential services (wallets, transactions, clients).
</Card>

<Card title="API Reference" icon="terminal" href="/api-reference/introduction">
  View endpoints and sample requests by service.
</Card>

## Quick Examples

List transactions in a wallet (Node.js)

```javascript theme={null}
import fetch from "node-fetch";

const res = await fetch(
  `${process.env.BASE_URL}/wallet/transactions/wallet/${process.env.WALLET_ID}`,
  {
    headers: { Authorization: `Bearer ${process.env.API_KEY}` },
  }
);
const data = await res.json();
```