nita_transfert_sdk

SDK Dart et Flutter officiel des APIs partenaires NITA (v2).

Il couvre l'authentification, la signature HMAC et les quatre produits : Partenaire → Cash (P2CASH), Partenaire → Wallet (P2W), Envoi inter-partenaire (P2P) et Achat en ligne.

Installation

dart pub add nita_transfert_sdk:^0.1.0-beta.1

Dans une application Flutter : flutter pub add nita_transfert_sdk:^0.1.0-beta.1.

Démarrage

NitaClient est une couche mince au-dessus du client généré. Elle obtient le jeton, le renouvelle avant expiration, signe chaque requête et décode l'enveloppe de réponse.

import 'dart:io';

import 'package:nita_transfert_sdk/api.dart';
import 'package:nita_transfert_sdk/nita_client.dart';

Future<void> main() async {
  final env = Platform.environment;
  final nita = await NitaClient.connect(
    baseUrl: env['NITA_BASE_URL'], // URL indiquée dans votre espace partenaire
    apiKey: env['NITA_API_KEY']!,
    login: env['NITA_LOGIN']!,
    password: env['NITA_PASSWORD']!,
    hmacSecret: env['NITA_HMAC_SECRET'],
  );

  try {
    final envoi = unwrap<TransactionResponseV2>(await nita.transactions.partenaireToCash(
      PartenaireToCashDtoV2(
        nom: 'Gadjan', prenom: 'Hadi', indicatif: '00227', numero: '92969858',
        requestId: newRequestId('p2c'), fraisInclus: false, montant: 5000,
        villeDestination: 'Niamey', nomDestinataire: 'Woessou', prenomDestinataire: 'Sofiane',
        indicatifDestinataire: '00227', numeroDestinataire: '90111213',
        motifTransaction: 'Paiement',
      ),
    ));
    print(envoi.codeEnvoi);
  } on NitaError catch (e) {
    print('${e.status} ${e.code} ${e.message}');
  }
}

unwrap renvoie le champ data de la réponse, ou lève NitaError quand NITA répond par une erreur métier.

Les autres produits suivent la même forme : nita.transactions, nita.achat, nita.p2p, ainsi que nita.compte, nita.localites, nita.checkStatus et nita.myNita.

Mode Test

Le sandbox reproduit le comportement de la production, signature comprise. Pointez baseUrl sur votre environnement de test et utilisez une clé nita_test_….

Licence

Logiciel propriétaire NITA Transfert. Voir LICENSE.