Wallets

Un wallet détient le solde de votre compte dans une devise. Un wallet USD est créé automatiquement à l'ouverture du compte ; créez un wallet supplémentaire pour chaque devise dans laquelle vous encaissez ou payez.

Les soldes sont exprimés en centièmes de la devise, quelle que soit la devise, sous forme de chaîne de caractères : "10000" vaut 100 CDF comme 100 XAF.

Devises disponibles

GET/api/v1/currencies

Renvoie les devises dans lesquelles un wallet peut être ouvert. Cet endpoint est public : aucune authentification n'est requise.

curl https://api.trustsend.africa/api/v1/currencies

Réponse 200

{
  "data": [
    {
      "code": "CDF",
      "numeric_code": "976",
      "name": "Congolese franc",
      "symbol": "FC",
      "decimals": 2,
      "country_code": "CD",
      "logo_url": "https://api.trustsend.africa/assets/currencies/CDF.svg",
      "is_active": true
    }
  ]
}

Champ	Description
code	Code ISO 4217 à 3 lettres
numeric_code	Code numérique ISO 4217, par exemple 976 pour CDF
symbol	Symbole usuel, null s'il n'en existe pas
decimals	Nombre de décimales ISO 4217 de la devise, à utiliser pour l'affichage
country_code	Pays émetteur (ISO 3166-1 alpha-2), null pour une devise partagée par plusieurs pays comme XAF ou XOF
logo_url	Logo SVG de la devise : drapeau du pays émetteur, ou badge avec le symbole pour une devise partagée

Créer un wallet

POST/api/v1/business/wallet

Paramètre	Type	Requis	Description
currency_code	string	Oui	Code d'une devise renvoyée par GET /api/v1/currencies, par exemple CDF

curl -X POST https://api.trustsend.africa/api/v1/business/wallet \
  -H "Authorization: Bearer $REEMITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "currency_code": "CDF" }'

Réponse 201

{
  "data": {
    "id": 38,
    "currency_code": "CDF",
    "logo_url": "https://api.trustsend.africa/assets/currencies/CDF.svg",
    "currency": {
      "code": "CDF",
      "numeric_code": "976",
      "name": "Congolese franc",
      "symbol": "FC",
      "decimals": 2,
      "country_code": "CD",
      "logo_url": "https://api.trustsend.africa/assets/currencies/CDF.svg",
      "is_active": true
    },
    "balance": "0",
    "status": "active",
    "created_at": "2026-09-12T10:00:00.000+00:00"
  },
  "message": "Wallet created"
}

Si un wallet existe déjà pour cette devise, l'API renvoie 200 avec le wallet existant : la requête peut être rejouée sans risque.

Erreurs : 422 si la devise est inconnue ou n'est pas ouverte aux nouveaux wallets.

remarque

Nécessite la fonctionnalité wallet.multi_currency dans votre offre.

Lister les wallets

GET/api/v1/business/wallet

Réponse 200

{
  "data": [
    {
      "id": 30,
      "currency_code": "USD",
      "logo_url": "https://api.trustsend.africa/assets/currencies/USD.svg",
      "currency": {
        "code": "USD",
        "numeric_code": "840",
        "name": "United States dollar",
        "symbol": "$",
        "decimals": 2,
        "country_code": "US",
        "logo_url": "https://api.trustsend.africa/assets/currencies/USD.svg",
        "is_active": true
      },
      "balance": "11000",
      "status": "active",
      "created_at": "2026-09-01T08:00:00.000+00:00",
      "updated_at": "2026-09-12T10:00:00.000+00:00"
    }
  ]
}

logo_url renvoie le logo de la devise du wallet, et currency le détail de la devise tel que renvoyé par GET /api/v1/currencies. L'ancien champ flag_url reste présent avec la même valeur que logo_url.

Consulter un wallet

GET/api/v1/business/wallet/:currency

Paramètre	Emplacement	Description
currency	Chemin	Code de devise du wallet, par exemple USD

Réponse 200

{
  "data": {
    "id": 30,
    "currency_code": "USD",
    "logo_url": "https://api.trustsend.africa/assets/currencies/USD.svg",
    "currency": { "code": "USD", "numeric_code": "840", "name": "United States dollar", "symbol": "$", "decimals": 2, "country_code": "US", "logo_url": "https://api.trustsend.africa/assets/currencies/USD.svg", "is_active": true },
    "balance": "11000",
    "status": "active",
    "per_transaction_limit": null,
    "daily_limit": null,
    "monthly_limit": null,
    "created_at": "2026-09-01T08:00:00.000+00:00",
    "updated_at": "2026-09-12T10:00:00.000+00:00"
  }
}

Champ	Description
per_transaction_limit	Montant maximal par opération, null si aucun plafond
daily_limit	Montant maximal cumulé par jour, null si aucun plafond
monthly_limit	Montant maximal cumulé par mois, null si aucun plafond

Erreurs : 404 si aucun wallet n'existe pour cette devise.