Collection Postman

1. Téléchargez Postman Desktop : postman.com/downloads
2. Cliquez sur Import dans Postman
3. Collez le JSON ci-dessous (Collection v2.1)
4. Configurez les variables api_key, api_secret, base_url
5. Lancez les requêtes — la signature HMAC est calculée automatiquement

Trois variables à définir au niveau de la collection :

À coller dans l'onglet Pre-request Script au niveau de la collection. La signature est recalculée à chaque requête.

JSconst apiSecret = pm.collectionVariables.get('api_secret');
const apiKey = pm.collectionVariables.get('api_key');
const ts = Math.floor(Date.now() / 1000).toString();

// Récupérer le body brut s'il existe
let body = '';
if (pm.request.body && pm.request.body.raw) {
    body = pm.request.body.raw;
}

// Calculer la signature HMAC-SHA256
const signature = CryptoJS.HmacSHA256(ts + body, apiSecret).toString(CryptoJS.enc.Hex);

// Injecter les en-têtes
pm.request.headers.add({key: 'X-NekaPay-Key', value: apiKey});
pm.request.headers.add({key: 'X-NekaPay-Timestamp', value: ts});
pm.request.headers.add({key: 'X-NekaPay-Signature', value: signature});

Enregistrez ce JSON dans un fichier nekapay.postman_collection.json puis importez-le.

JSON{
  "info": {
    "name": "Neka Paie API",
    "description": "Collection officielle Neka Paie - API Orange Money",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {"type": "noauth"},
  "event": [{
    "listen": "prerequest",
    "script": {
      "type": "text/javascript",
      "exec": [
        "const apiSecret = pm.collectionVariables.get('api_secret');",
        "const apiKey = pm.collectionVariables.get('api_key');",
        "const ts = Math.floor(Date.now() / 1000).toString();",
        "let body = '';",
        "if (pm.request.body && pm.request.body.raw) body = pm.request.body.raw;",
        "const signature = CryptoJS.HmacSHA256(ts + body, apiSecret).toString(CryptoJS.enc.Hex);",
        "pm.request.headers.add({key: 'X-NekaPay-Key', value: apiKey});",
        "pm.request.headers.add({key: 'X-NekaPay-Timestamp', value: ts});",
        "pm.request.headers.add({key: 'X-NekaPay-Signature', value: signature});"
      ]
    }
  }],
  "variable": [
    {"key": "base_url", "value": "{{ nekapay_sandbox_base_url }}"},
    {"key": "api_key", "value": "nk_test_REPLACE_ME"},
    {"key": "api_secret", "value": "REPLACE_ME"}
  ],
  "item": [
    {
      "name": "Cash-In",
      "request": {
        "method": "POST",
        "header": [{"key": "Content-Type", "value": "application/json"}],
        "url": {"raw": "{{base_url}}/payments/cashin", "host": ["{{base_url}}"], "path": ["payments", "cashin"]},
        "body": {
          "mode": "raw",
          "raw": "{\n  \"merchant_order_id\": \"order_{{$timestamp}}\",\n  \"amount\": 50000,\n  \"currency\": \"XOF\",\n  \"customer_msisdn\": \"+22376123456\",\n  \"country_code\": \"ML\"\n}"
        }
      }
    },
    {
      "name": "Cash-Out",
      "request": {
        "method": "POST",
        "header": [{"key": "Content-Type", "value": "application/json"}],
        "url": {"raw": "{{base_url}}/payments/cashout", "host": ["{{base_url}}"], "path": ["payments", "cashout"]},
        "body": {
          "mode": "raw",
          "raw": "{\n  \"merchant_order_id\": \"payout_{{$timestamp}}\",\n  \"amount\": 100000,\n  \"beneficiary_msisdn\": \"+22376987654\",\n  \"currency\": \"XOF\",\n  \"reason\": \"Test sandbox\"\n}"
        }
      }
    },
    {
      "name": "Get Transaction Status",
      "request": {
        "method": "GET",
        "url": {"raw": "{{base_url}}/payments/{{transaction_id}}", "host": ["{{base_url}}"], "path": ["payments", "{{transaction_id}}"]}
      }
    },
    {
      "name": "Refund",
      "request": {
        "method": "POST",
        "header": [{"key": "Content-Type", "value": "application/json"}],
        "url": {"raw": "{{base_url}}/refunds", "host": ["{{base_url}}"], "path": ["refunds"]},
        "body": {
          "mode": "raw",
          "raw": "{\n  \"transaction_id\": \"{{transaction_id}}\",\n  \"reason\": \"Annulation client\"\n}"
        }
      }
    },
    {
      "name": "Get Balances",
      "request": {
        "method": "GET",
        "url": {"raw": "{{base_url}}/balances", "host": ["{{base_url}}"], "path": ["balances"]}
      }
    },
    {
      "name": "Export Transactions (CSV)",
      "request": {
        "method": "GET",
        "url": {
          "raw": "{{base_url}}/transactions/export?date_from=2026-04-01&date_to=2026-04-30&format=csv",
          "host": ["{{base_url}}"],
          "path": ["transactions", "export"],
          "query": [
            {"key": "date_from", "value": "2026-04-01"},
            {"key": "date_to", "value": "2026-04-30"},
            {"key": "format", "value": "csv"}
          ]
        }
      }
    }
  ]
}