Encaissez et versez par Mobile Money depuis vos serveurs

// Node.js 18+ (fetch et crypto intégrés). Identifiants lus dans l'environnement.
const crypto = require('node:crypto');
const TAMO_BASE_URL = 'https://tamoapi.tasa.pro/api/v1';

async function tamoRequest(method, path, body = null, idempotencyKey = '') {
  const url = new URL(TAMO_BASE_URL + path);
  const raw = body === null ? '' : JSON.stringify(body); // sérialisé UNE fois
  const headers = {
    Accept: 'application/json',
    'Content-Type': 'application/json',
    'X-API-Token': process.env.TAMO_API_TOKEN,
  };

  // Toute écriture est signée, sur les octets EXACTS envoyés.
  if (method !== 'GET') {
    const timestamp = Math.floor(Date.now() / 1000).toString();
    const nonce = crypto.randomBytes(16).toString('hex');
    const canonical = [method, url.pathname + url.search, timestamp, nonce, idempotencyKey, raw].join('\n');
    headers['X-Signature-Version'] = '2';
    headers['X-Timestamp'] = timestamp;
    headers['X-Nonce'] = nonce;
    headers['X-Signature'] = crypto
      .createHmac('sha256', process.env.TAMO_API_SECRET)
      .update(canonical, 'utf8')
      .digest('hex');
    if (idempotencyKey) headers['Idempotency-Key'] = idempotencyKey;
  }

  // Une erreur réseau rend l'issue INCONNUE : relancez avec la MÊME clé.
  const res = await fetch(url, { method, headers, body: method === 'GET' ? undefined : raw });
  return { status: res.status, body: await res.json() };
}

// Encaisser (Cash In) : 201 créée, 200 rejeu de la même clé
const collecte = await tamoRequest('POST', '/collections', {
  product_id: 'f415c255-821d-4314-8628-61beea638215',
  operator_code: 'MTN_CG',
  amount: 5000,
  phone_number: '+242060000000',
  merchant_reference: 'CMD-10045',
  payer_name: 'Client Exemple',
  description: 'Commande CMD-10045',
}, 'collecte-CMD-10045');

console.log(collecte.status, collecte.body.data?.reference ?? collecte.body.message);

// Suivre une transaction
const statut = await tamoRequest('GET', '/collections/status/' + encodeURIComponent(collecte.body.data.reference));
console.log(statut.body.data.status);

{
  "message": "Transaction initiée avec succès.",
  "data": {
    "id": "dca9d0a4-fa57-4fcd-b772-3c6ce403369d",
    "reference": "TAMOC-OP7Y-261002-M8XFKU",
    "merchant_reference": "CMD-10045",
    "type": "collection",
    "status": "pending",
    "under_review": false,
    "operator": { "code": "MTN_CG", "name": "Opérateur" },
    "currency": "XAF",
    "amounts": { "requested": 5000, "fee": 100, "net": 4900 },
    "solde": { "sens": "credit", "montant": 4900, "applique": false },
    "expires_at": "2026-10-02T10:58:49.000000Z"
  }
}