> ## 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.

# Quickstart

> Quickly integrate key services: wallets, transactions, clients.

## Objective

This guide helps you quickly integrate the essential Cartevo services.

## Step 1 — Wallets

Create a wallet

```http theme={null}
POST /wallets
Content-Type: application/json
Authorization: Bearer <token>

{
  "currency": "USD",
  "country_iso_code": "US"
}

```

List Wallets

```http theme={null}
GET /wallets
Authorization: Bearer <token>
```

cURL Example

```bash theme={null}
curl -X GET "$BASE_URL/wallets" -H "Authorization: Bearer $API_KEY"
```

Réponse (200)

```json theme={null}
[
  {
    "id": "wlt_123",
    "currency": "USD",
    "balance": 150.25,
    "created_at": "2025-10-01T12:00:00Z"
  }
]
```

## Step 2 — Funding & Deposit

Local funding

```http theme={null}
POST /wallets/fund
Content-Type: application/json
Authorization: Bearer <token>

{
  "userId": "<userId>",
  "walletId": "<walletId>",
  "amount": 10000,
  "phone": "+2376xxxxxxx",
  "operator": "ORANGE",
  "currency": "XAF"
}
```

Deposit with exchange

```http theme={null}
POST /wallets/deposit
Content-Type: application/json
Authorization: Bearer <token>

{
  "sourceWallet": {
    "id": "<walletIdXAF>",
    "currency": "XAF",
    "amount": 10000,
    "feeAmount": 0,
    "totalAmount": 10000
  },
  "destinationWallet": {
    "id": "<walletIdUSD>",
    "currency": "USD",
    "amount": 15
  },
  "exchangeRate": {
    "rate": 650,
    "fromCurrency": "XAF",
    "toCurrency": "USD"
  }
}
```

cURL example

```bash theme={null}
curl -X POST "$BASE_URL/wallets/deposit" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d @payload.json
```

## Step 3 — Transactions

List wallet transactions

```http theme={null}
GET /wallet/transactions/wallet/<walletId>
Authorization: Bearer <token>
```

Useful filters

* `status`: SUCCESS, PENDING, FAILED
* `type`: FUND, DEPOSIT, TRANSFER
* `page`, `limit`: pagination

## Step 4 — Clients

Step 4 — Customers

```http theme={null}
POST /customers
Content-Type: application/json
Authorization: Bearer <token>

{
  "first_name": "Jane",
  "last_name": "Doe",
  "email": "jane@example.com",
  "phone_number": "+2376xxxxxxx",
  "country_iso_code": "CM"
}
```

Tips

* Validate emails and country codes on the client side
* Reconcile customer transactions `GET /customers/:id/transactions`