Changements a venir

Nous travaillons sur de nouvelles fonctionnalites passionnantes qui amelioreront votre experience. Pendant que nous continuons a developper ces mises a jour, vous pouvez continuer a construire !

Nous recommandons de consulter regulierement ce changelog pour les dernieres mises a jour et de planifier vos cycles de developpement en consequence. Vos retours sont precieux pour nous, alors n’hesitez pas a partager toute suggestion ou probleme que vous rencontrez.

Mises a jour produit

Nouvelles versions et ameliorations

AmeliorationsMises a jour d'Actifs

Mises a jour des adresses de contrat cNGN

L’equipe cNGN a deploye de nouvelles adresses de contrat sur 5 reseaux. Les adresses precedentes sont maintenant etiquetees “Old v2” et seront progressivement supprimees.

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

Reseau	Nouvelle adresse de contrat cNGN
Ethereum	`0xF55E56423e6b50808fD07cB62b6A32B91903f50E`
BNB Chain	`0x8a078b182bA9649c03982c2a80CDcc81cdc99dA8`
Base	`0xEFdF04BAfE0ebabb5F5cD9e3f36564f51CFe1530`
Asset Chain	`0x00F0a33d9AFaC108A4963D4Cb4Ef6A9C6B8D8859`
Arc	`0x1716Df6A18DcFF031BFD209aDB8035174AdC0D31`

Tokens cNGN de test

Besoin de cNGN de test pour votre integration sandbox (testnet) ? Utilisez le cNGN Faucet officiel pour obtenir des tokens de test.Pour plus d’informations sur le projet stablecoin cNGN, visitez le depot officiel.

Changement MajeurComptes Virtuels

Changements Majeurs de l’API Comptes Virtuels

Changement Majeur : Cette mise a jour est maintenant active. Les integrations existantes utilisant l’API Comptes Virtuels doivent passer au nouveau format de reponse.

Pourquoi Ce Changement

Auparavant, chaque portefeuille ou adresse ne pouvait avoir qu’un seul compte virtuel. Nous avons entendu des entreprises qui ont besoin de plusieurs comptes virtuels par portefeuille—par exemple, pour attribuer des comptes separes a differents clients ou cas d’utilisation. Cette mise a jour permet cette flexibilite tout en maintenant la compatibilite ascendante pour recuperer des comptes individuels.

Ce Qui a Change

Endpoint	Comportement Precedent	Nouveau Comportement
`GET /wallets/{walletId}/virtual-accounts`	Retournait un objet unique	Retourne un tableau pagine
`GET /wallets/{walletId}/addresses/{addressId}/virtual-accounts`	Retournait un objet unique	Retourne un tableau pagine

Nouveaux Endpoints

Pour recuperer un compte virtuel specifique (equivalent a l’ancienne reponse objet unique), utilisez ces nouveaux endpoints :

Endpoint	Description
`GET /wallets/{walletId}/virtual-accounts/{virtualAccountId}`	Obtenir un compte virtuel specifique
`GET /wallets/{walletId}/virtual-accounts/{virtualAccountId}/transactions`	Obtenir les transactions d’un compte virtuel
`POST /wallets/{walletId}/virtual-accounts/{virtualAccountId}/regenerate`	Regenerer un compte virtuel
`GET /wallets/{walletId}/addresses/{addressId}/virtual-accounts/{virtualAccountId}`	Obtenir un compte virtuel specifique d’adresse enfant
`GET /wallets/{walletId}/addresses/{addressId}/virtual-accounts/{virtualAccountId}/transactions`	Obtenir les transactions de compte virtuel d’adresse enfant
`POST /wallets/{walletId}/addresses/{addressId}/virtual-accounts/{virtualAccountId}/regenerate`	Regenerer un compte virtuel d’adresse enfant

Details de Pagination

Tous les endpoints de liste supportent maintenant la pagination avec ces parametres :

Parametre	Type	Par Defaut	Maximum	Description
`page`	integer	`1`	—	Numero de page a recuperer
`limit`	integer	`10`	`100`	Nombre d’enregistrements par page

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

Avant — Reponse objet unique :

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

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

Apres — Reponse tableau pagine :

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}`);

Pour obtenir un compte specifique par ID (recommande) :

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

Endpoint de liste GET /wallets/{walletId}/virtual-accounts :

{
  "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
  }
}

Endpoint de compte unique GET /wallets/{walletId}/virtual-accounts/{virtualAccountId} :

{
  "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]

Nouvelle FonctionnaliteComptes Virtuels

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

Voici les endpoints API principaux pour les operations des Comptes Virtuels :

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)

Pour plus d’informations, consultez la documentation des Comptes Virtuels et la Reference API.

AmeliorationsMises a jour d'Actifs

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

Reseau	Nouvelle Adresse de Contrat cNGN
ASSETCHAIN	0x4c00E85cd0B0307D8ED0b5534Bc678776C4aa7D3
BASE	0x929A08903C22440182646Bb450a67178Be402f7f
BNBCHAIN	0x20354A3Ad3B67836ab9c6D7D82cF5e5Ddfe104dD
ETHEREUM	0xd076ceCB8af5D92F7f6F32bDf24Da708859593d3
POLYGON	0xf24B1Cee8cA70341FcefBCa10e7e4Db9A4896486
LISK	0x999E3A32eF3F9EAbF133186512b5F29fADB8a816

Adresse Tron USDT Mise a Jour

Reseau	Nouvelle Adresse de Contrat Tron USDT
TRON	TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf

Pour plus d’informations sur le projet stablecoin cNGN, visitez le depot officiel.

Journal des Modifications

Apercu

Changements a venir

Mises a jour produit

Mises a jour des adresses de contrat cNGN

Ce qui a change

Ce que vous devez faire

Nouvelles adresses de contrat

Tokens cNGN de test

Changements Majeurs de l’API Comptes Virtuels

Pourquoi Ce Changement

Ce Qui a Change

Nouveaux Endpoints

Nouvelles Fonctionnalites

Guide de Migration

Exemple de Reponse API

Besoin d’Aide ?

API Comptes Virtuels

Ce que vous devez faire

Endpoints API

Endpoints du Portefeuille Principal

Endpoints de l’Adresse Enfant

Fonctionnalites Cles

Mises a jour des Adresses cNGN Testnet

Ce que vous devez faire

Adresses Testnet Mises a Jour

Adresse Tron USDT Mise a Jour

​Changements a venir

​Mises a jour produit

​Mises a jour des adresses de contrat cNGN

​Ce qui a change

​Ce que vous devez faire

​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

​Guide de Migration

​Exemple de Reponse API

​Besoin d’Aide ?

​API Comptes Virtuels

​Ce que vous devez faire

​Endpoints API

​Endpoints du Portefeuille Principal

​Endpoints de l’Adresse Enfant

​Fonctionnalites Cles

​Mises a jour des Adresses cNGN Testnet

​Ce que vous devez faire

​Adresses Testnet Mises a Jour

​Adresse Tron USDT Mise a Jour

Changements a venir

Mises a jour produit

Mises a jour des adresses de contrat cNGN

Ce qui a change

Ce que vous devez faire

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

Guide de Migration

Exemple de Reponse API

Besoin d’Aide ?

API Comptes Virtuels

Ce que vous devez faire

Endpoints API

Endpoints du Portefeuille Principal

Endpoints de l’Adresse Enfant

Fonctionnalites Cles

Mises a jour des Adresses cNGN Testnet

Ce que vous devez faire

Adresses Testnet Mises a Jour

Adresse Tron USDT Mise a Jour