Collection Postman

Testez l'API SOAMTAR sans écrire de code : la collection contient toutes les requêtes utiles en Sierra Leone (compte, paiements Orange Money, retraits, remboursements, webhooks).

Importer la collection

1. Téléchargez soamtar-api.postman_collection.json.
2. Dans Postman : Import → File, puis choisissez le fichier.
3. Ouvrez la collection → onglet Variables et renseignez :

Variable	Valeur
base_url	https://app.so-amtar.com/v1 (déjà renseignée)
api_key	votre clé secrète — commencez par sk_test_…
payer_phone	numéro Orange Money du payeur, ex. +23276000001
webhook_url	l'URL HTTPS publique qui recevra vos webhooks
sign_requests	true pour signer les requêtes en HMAC (facultatif)

transaction_id, reference, payout_id et refund_id se remplissent automatiquement d'une requête à l'autre. Un Idempotency-Key est généré à chaque envoi.

Dossiers

• Compte — santé de l'API (valide la clé) et solde.
• Paiements (encaissements) — créer un paiement Orange Money, le consulter, lister.
• Paiements sortants — retraits vers un numéro Orange Money.
• Remboursements — rembourser un paiement (total ou partiel), consulter un remboursement, lister les remboursements.
• Webhooks — enregistrer un endpoint et envoyer un webhook de test (événement webhook.test).

Avec une clé sk_test_, les paiements sont simulés : aucun débit réel.

Insomnia, Bruno et générateurs de code

Téléchargez la spécification openapi.yaml puis :

• Insomnia : Create → Import → le fichier.
• Bruno : bru import openapi --source ./openapi.yaml --output ./soamtar-collection
• Postman (à partir de l'OpenAPI) : Import → File → openapi.yaml.

cURL

curl -X POST https://app.so-amtar.com/v1/payments \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Idempotency-Key: order-TEST-001" \
  -H "Content-Type: application/json" \
  -d '{"merchant_ref":"TEST-001","amount":"150.00","currency":"SLE","provider":"orange_money_sl","payer":{"phone":"+23276000001"}}'