​

Mises a jour des adresses de contrat cNGN

​

Ce qui a change

• Nouveau deploiement cNGN : Adresses de contrat mises a jour pour cNGN sur Ethereum, BNB Chain, Base, Asset Chain et Arc
• Adresses precedentes reetiquetees : Les adresses existantes sont maintenant marquees comme “Old v2” dans le tableau de bord
• Support d’un nouveau reseau : cNGN est maintenant disponible sur le reseau Arc

​

Ce que vous devez faire

• Allez dans votre tableau de bord et ajoutez les nouveaux actifs cNGN (recherchez ceux sans l’etiquette “Old”)
• Mettez a jour vos integrations pour utiliser les nouvelles adresses de contrat
• Les adresses precedentes continueront de fonctionner pendant la periode de transition

​

Nouvelles adresses de contrat

​

Tokens cNGN de test

​

Changements Majeurs de l’API Comptes Virtuels

​

Pourquoi Ce Changement

​

Ce Qui a Change

​

Nouveaux Endpoints

​

Details de Pagination

​

Nouvelles Fonctionnalites

• Labels de comptes virtuels : Ajoutez des labels personnalises pour organiser les comptes (ex., “Client A”, “Paie”)
• Regeneration de comptes : Generez de nouveaux numeros de compte avec suivi de raison pour l’audit
• Historique des transactions : Consultez les transactions liees a des comptes virtuels specifiques

​

Guide de Migration

const response = await fetch(`/wallets/${walletId}/virtual-accounts`);
const account = await response.json();

console.log(account.accountNumber);
console.log(account.bankName);

const response = await fetch(`/wallets/${walletId}/virtual-accounts`);
const { data, meta } = await response.json();

// Gerer le cas du tableau vide
if (data.length === 0) {
  console.log('Aucun compte virtuel trouve');
  return;
}

// Obtenir le premier compte (equivalent au comportement precedent)
const account = data[0];
console.log(account.accountNumber);
console.log(account.bankName);

// Ou iterer a travers tous les comptes
for (const account of data) {
  console.log(account.accountNumber);
}

// Informations de pagination disponibles dans meta
console.log(`Page ${meta.currentPage} sur ${meta.totalPages}`);

const response = await fetch(`/wallets/${walletId}/virtual-accounts/${virtualAccountId}`);

if (!response.ok) {
  console.log('Compte virtuel non trouve');
  return;
}

const { data } = await response.json();
console.log(data.accountNumber);

​

Exemple de Reponse API

{
  "message": "Virtual accounts retrieved successfully",
  "statusCode": 200,
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "accountNumber": "8012345678",
      "accountName": "Blockradar/John Doe",
      "bankName": "Wema Bank",
      "bankCode": "035",
      "isActive": true,
      "type": "AUTO_FUNDING",
      "label": "Customer Deposits",
      "createdAt": "2026-01-22T10:30:00.000Z",
      "updatedAt": "2026-01-22T10:30:00.000Z"
    }
  ],
  "meta": {
    "itemCount": 1,
    "totalItems": 1,
    "itemsPerPage": 10,
    "totalPages": 1,
    "currentPage": 1
  }
}

{
  "message": "Virtual account retrieved successfully",
  "statusCode": 200,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "accountNumber": "8012345678",
    "accountName": "Blockradar/John Doe",
    "bankName": "Wema Bank",
    "bankCode": "035",
    "isActive": true,
    "type": "AUTO_FUNDING",
    "label": "Customer Deposits",
    "createdAt": "2026-01-22T10:30:00.000Z",
    "updatedAt": "2026-01-22T10:30:00.000Z"
  }
}

​

Besoin d’Aide ?

• Documentation : Guide des Comptes Virtuels
• Reference API : Endpoints des Comptes Virtuels
• Support par email : [email protected]

​

API Comptes Virtuels

• Nouvelle fonctionnalite : L’API Comptes Virtuels permet aux entreprises de creer et gerer des comptes bancaires virtuels lies aux portefeuilles principaux ou aux adresses enfants
• Conversion fiat-vers-stablecoin : Les clients peuvent recevoir des paiements NGN via des virements bancaires traditionnels, automatiquement convertis en stablecoins cNGN
• Support de financement automatique : Les comptes de type AUTO_FUNDING emettent automatiquement du cNGN lorsque les paiements fiat sont recus et le transferent vers les portefeuilles lies
• Integration portefeuille principal : Creez des comptes virtuels directement lies aux portefeuilles principaux
• Integration adresse enfant : Creez des comptes virtuels lies a des adresses enfants specifiques pour un controle granulaire
• Gestion de compte : Activez ou desactivez les comptes virtuels pour controler le comportement du financement automatique

​

Ce que vous devez faire

• Activer la fonctionnalite : Contactez [email protected] pour activer les comptes virtuels pour votre entreprise
• Assurer le support cNGN : Assurez-vous que votre portefeuille principal prend en charge l’actif stablecoin cNGN
• Mainnet uniquement : Notez que les comptes virtuels sont uniquement disponibles dans l’environnement MAINNET
• Consulter les endpoints API : Consultez la documentation de l’API Comptes Virtuels pour les details d’implementation

​

Endpoints API

​

Endpoints du Portefeuille Principal

• POST /wallets//virtual-accounts - Creer un compte virtuel pour un portefeuille principal
• GET /wallets//virtual-accounts - Recuperer les details du compte virtuel
• PATCH /wallets//virtual-accounts/ - Mettre a jour le statut du compte virtuel

​

Endpoints de l’Adresse Enfant

• POST /wallets//addresses//virtual-accounts - Creer un compte virtuel pour une adresse enfant
• GET /wallets//addresses//virtual-accounts - Recuperer les details du compte virtuel
• PATCH /wallets//addresses//virtual-accounts/ - Mettre a jour le statut du compte virtuel

​

Fonctionnalites Cles

• Devise prise en charge : NGN (Naira nigerien) pour les paiements fiat, cNGN pour la conversion stablecoin
• Flux de financement automatique : Emission et transfert automatiques de cNGN lorsque les paiements sont recus (type AUTO_FUNDING)
• Activation de compte : Controlez le comportement du financement automatique en activant ou desactivant les comptes
• Gestion des clients : Creez des comptes avec les informations client (prenom, nom, email, telephone)

​

Mises a jour des Adresses cNGN Testnet

• Adresses cNGN testnet mises a jour : L’equipe cNGN a mis a jour leurs adresses testnet sur plusieurs reseaux
• Nouveau support d’actifs : Ajout du support pour le stablecoin cNGN mis a jour dans le tableau de bord
• Gestion des actifs : Les adresses testnet precedentes sont maintenant etiquetees comme “old” et seront supprimees dans 30 jours
• Support Tron USDT : Ajout de l’adresse Tron USDT mise a jour avec l’adresse precedente etiquetee comme “old”

​

Ce que vous devez faire

• Allez dans votre tableau de bord et ajoutez les nouveaux actifs cNGN (recherchez ceux sans l’etiquette “old”)
• Mettez a jour vos integrations pour utiliser les nouvelles adresses testnet
• Les anciennes adresses testnet seront automatiquement supprimees apres 30 jours
• Note : Ces changements ne s’appliquent qu’aux environnements testnet - les adresses mainnet restent inchangees

​

Adresses Testnet Mises a Jour

​

Adresse Tron USDT Mise a Jour