Wallets

Le wallet est le compte prépayé XOF d’un utilisateur, d’un marchand ou d’un partenaire. Chaque entité Royal Finance a au moins un wallet.

Endpoints

L’objet Wallet

{
  "id":         "wal_4M8z2Lp",
  "object":     "wallet",
  "owner":      { "type": "merchant", "id": "mer_5K4z2Yp" },
  "currency":   "XOF",
  "balance":    128500,
  "available":  128500,
  "pending":    0,
  "frozen":     0,
  "status":     "active",
  "created_at": "2026-01-12T09:14:22Z"
}

| Champ | Description | |-------------|------------------------------------------------------| | balance | Solde total (disponible + pending + frozen) | | available | Utilisable immédiatement pour des sorties | | pending | Encaissements non encore réglés | | frozen | Gel KYC, contentieux, anti-fraude |

Virement interne

curl -X POST https://api.royalstack.com/api/v1/wallets/transfer \
  -H "Authorization: Bearer rs_test_••••" \
  -H "Idempotency-Key: 9a12-7f3d" \
  -H "Content-Type: application/json" \
  -d '{
    "from":        "wal_4M8z2Lp",
    "to":          "wal_8H1k5Rp",
    "amount":      10000,
    "description": "Reversement marketplace"
  }'