Questions fréquentes

Oui. Le mode sandbox est activé par défaut sur tous les nouveaux comptes. Vous pouvez simuler des paiements sans frais ni mouvements réels.

Cash-In = encaissement (le client paie le marchand). Cash-Out = décaissement (le marchand reverse vers un bénéficiaire). Les deux utilisent le même mécanisme HMAC mais des endpoints distincts.

L'idempotence est garantie. La même requête renvoie la transaction d'origine sans en créer une nouvelle. Aucune action côté votre code n'est nécessaire — c'est un filet de sécurité contre les retries réseau.

L'état PENDING dure tant que le client n'a pas saisi son PIN ou que l'opérateur Orange n'a pas notifié le résultat. Au bout de ~5 minutes, la transaction passe automatiquement en EXPIRED.

1) Vérifier que votre URL est accessible publiquement et renvoie 2xx. 2) Consulter votre dashboard pour voir l'historique des envois. 3) En fallback, interroger GET /payments/{id} pour récupérer le statut.

Utiliser POST /api/v1/refunds avec le transaction_id. Un remboursement total ou partiel est possible. Seules les transactions en SUCCESS sont remboursables.

Non. Le préfixe MSISDN doit correspondre à une filiale activée. Si votre client n'a pas de wallet Orange dans un des pays supportés, l'API renvoie une erreur UNKNOWN_COUNTRY (422).

Les fonds sont crédités sur votre compte marchand dès la confirmation Orange. Le règlement vers votre compte bancaire suit le calendrier convenu (J+1 ou J+2 selon la filiale).

Les frais sont définis dans votre contrat (typiquement un pourcentage sur les Cash-In réussis). Ils sont déduits automatiquement du solde. Le champ fee_minor de la transaction indique les frais appliqués.

1) Suspendre le compte ou demander à l'admin de le faire. 2) Régénérer les clés depuis votre espace marchand. 3) Auditer les transactions récentes via le journal pour détecter d'éventuelles fraudes.

1) Valider les tests E2E sur tous les pays cibles. 2) Demander l'activation production. 3) Vous recevez de nouvelles clés (préfixe nk_live_). 4) Bascule de sandbox.api.nekapaie.com vers api.nekapaie.com. 5) Test à faible montant validé.