GET/api/v1/payments/walletsClé API

Lister les wallets

Retourne les wallets associés au marchand authentifié.

Réponse (data)

Nom	Type	Requis	Description
object	string	Oui	Toujours wallet
id	string	Oui	walletId
merchantId	string	Oui	Marchand propriétaire
label	string	Oui	Libellé affiché
available	string	Oui	Solde disponible
held	string	Oui	Fonds retenus
balance	string	Oui	Solde ledger
currency	string	Oui	Devise

Exemple réponse

json

{
  "success": true,
  "data": [
    {
      "object": "wallet",
      "id": "6015fa0e-0e44-461e-9ec8-b598ca19c14b",
      "merchantId": "mch-1",
      "label": "Boutique Kinshasa",
      "balance": "7600.00",
      "available": "7350.00",
      "held": "250.00",
      "pending": "250.00",
      "reserved": "0.00",
      "ledgerBalance": "7600.00",
      "currency": "USD"
    }
  ],
  "error": null
}

Exemples

bash

curl -X GET https://api.dev.izzi-finance.com/api/v1/api/v1/payments/wallets \
  -H "Authorization: Bearer izzi_mk_sandbox_…" \
  -H "Content-Type: application/json"

Voir aussi

GET/api/v1/payments/walletClé API

Wallet principal

Retourne le wallet principal du marchand.

Réponse (data)

Nom	Type	Requis	Description
object	string	Oui	Toujours wallet
id	string	Oui	walletId
merchantId	string	Oui	Marchand propriétaire
label	string	Oui	Libellé affiché
available	string	Oui	Solde disponible
held	string	Oui	Fonds retenus
balance	string	Oui	Solde ledger
currency	string	Oui	Devise

Exemple réponse

json

{
  "success": true,
  "data": {
    "object": "wallet",
    "id": "6015fa0e-0e44-461e-9ec8-b598ca19c14b",
    "merchantId": "mch-1",
    "label": "Boutique Kinshasa",
    "balance": "7600.00",
    "available": "7350.00",
    "held": "250.00",
    "pending": "250.00",
    "reserved": "0.00",
    "ledgerBalance": "7600.00",
    "currency": "USD"
  },
  "error": null
}

Exemples

bash

curl -X GET https://api.dev.izzi-finance.com/api/v1/api/v1/payments/wallet \
  -H "Authorization: Bearer izzi_mk_sandbox_…" \
  -H "Content-Type: application/json"

Voir aussi

GET/api/v1/payments/wallet/transactionsClé API

Historique wallet

Transactions du wallet marchand (charges crédit, payouts débit).

Paramètres de requête

Nom	Type	Requis	Description
page	number	—	Page (défaut 1)
limit	number	—	Taille page (défaut 25)
type	string	—	WALLET_CREDIT ou WALLET_DEBIT
status	string	—	Filtrer par statut

Réponse (data)

Nom	Type	Requis	Description
object	string	Oui	Toujours wallet_transaction
id	string	Oui	Identifiant mouvement
type	string	Oui	WALLET_CREDIT ou WALLET_DEBIT
amount	string	Oui	Montant
reference	string	Oui	Référence métier
status	string	Oui	Statut source (charge ou payout)
createdAt	string	Oui	Date ISO 8601

Exemple réponse

json

{
  "success": true,
  "data": [
    {
      "object": "wallet_transaction",
      "id": "a76c830e-b7f1-4fd4-b5b6-618ffdb76b62",
      "reference": "ORDER-1234",
      "type": "WALLET_CREDIT",
      "amount": "1462.50",
      "currency": "USD",
      "status": "CAPTURED",
      "createdAt": "2026-08-28T10:00:00.000Z"
    }
  ],
  "error": null,
  "meta": {
    "page": 1,
    "pageSize": 25,
    "total": 1,
    "totalPages": 1
  }
}

Exemples

bash

curl -X GET https://api.dev.izzi-finance.com/api/v1/api/v1/payments/wallet/transactions \
  -H "Authorization: Bearer izzi_mk_sandbox_…" \
  -H "Content-Type: application/json"

Voir aussi

POST/api/v1/payments/wallets/creditClé API

Créditer un wallet (manuel)

Crédit manuel du wallet marchand (sandbox / opérations institutionnelles).

Corps de requête

Nom	Type	Requis	Description
amount	string	Oui	Montant à créditer
currency	string	—	Devise (défaut : devise du marchand)
reason	string	—	Motif du crédit
idempotencyKey	string	Oui	Clé d'idempotence
merchantId	string	—	Marchand cible (optionnel avec clé scopée)

Exemple requête

json

{
  "amount": "1000",
  "currency": "USD",
  "reason": "sandbox_topup",
  "idempotencyKey": "credit-sandbox-001"
}

Réponse (data)

Nom	Type	Requis	Description
object	string	Oui	Toujours wallet
id	string	Oui	walletId
merchantId	string	Oui	Marchand propriétaire
label	string	Oui	Libellé affiché
available	string	Oui	Solde disponible
held	string	Oui	Fonds retenus
balance	string	Oui	Solde ledger
currency	string	Oui	Devise

Exemple réponse

json

{
  "success": true,
  "data": {
    "object": "wallet",
    "id": "6015fa0e-0e44-461e-9ec8-b598ca19c14b",
    "merchantId": "mch-1",
    "label": "Boutique Kinshasa",
    "balance": "7600.00",
    "available": "7350.00",
    "held": "250.00",
    "pending": "250.00",
    "reserved": "0.00",
    "ledgerBalance": "7600.00",
    "currency": "USD"
  },
  "error": null
}

Erreurs

IDEMPOTENCY_KEY_REQUIRED (400) — Header Idempotency-Key requis

Exemples

bash

curl -X POST https://api.dev.izzi-finance.com/api/v1/api/v1/payments/wallets/credit \
  -H "Authorization: Bearer izzi_mk_sandbox_…" \
  -H "Idempotency-Key: charge-order-1234-unique" \
  -H "Content-Type: application/json" \
  -d '{
  "amount": "1000",
  "currency": "USD",
  "reason": "sandbox_topup",
  "idempotencyKey": "credit-sandbox-001"
}'

Voir aussi

GET/api/v1/merchant/merchants/:merchantId/walletClé API

Snapshot wallet marchand

Solde et métriques wallet via l'API merchant scopée.

Paramètres de chemin

Nom	Type	Requis	Description
merchantId	string	Oui	UUID marchand

Réponse (data)

Nom	Type	Requis	Description
object	string	Oui	Toujours wallet
id	string	Oui	walletId
merchantId	string	Oui	Marchand propriétaire
label	string	Oui	Libellé affiché
available	string	Oui	Solde disponible
held	string	Oui	Fonds retenus
balance	string	Oui	Solde ledger
currency	string	Oui	Devise

Exemple réponse

json

{
  "success": true,
  "data": {
    "object": "wallet",
    "id": "6015fa0e-0e44-461e-9ec8-b598ca19c14b",
    "merchantId": "mch-1",
    "label": "Boutique Kinshasa",
    "balance": "7600.00",
    "available": "7350.00",
    "held": "250.00",
    "pending": "250.00",
    "reserved": "0.00",
    "ledgerBalance": "7600.00",
    "currency": "USD"
  },
  "error": null
}

Exemples

bash

curl -X GET https://api.dev.izzi-finance.com/api/v1/api/v1/merchant/merchants/:merchantId/wallet \
  -H "Authorization: Bearer izzi_mk_sandbox_…" \
  -H "Content-Type: application/json"