Déclencheurs Sandbox

La commande sandbox trigger vous permet de simuler des événements du cycle de vie des paiements et des payouts en mode sandbox — utile pour tester vos handlers webhook sans attendre les callbacks réels des providers.

Déclencheurs disponibles

Nom du déclencheur	Description	Flag requis
payment_succeeded	Simule un callback de paiement réussi	--payment-intent
payment_failed	Simule un callback de paiement échoué	--payment-intent
payout_paid	Simule un callback de payout réussi	--payout
payout_failed	Simule un callback de payout échoué	--payout

Utilisation

Simuler un paiement réussi

# 1. Créer un paiement
ikw payments create --amount 5000 --currency XOF --json
# → { "id": "pi_abc123", ... }

# 2. Déclencher le callback de succès
ikw sandbox trigger payment_succeeded --payment-intent pi_abc123
# → ok

Simuler un paiement échoué

ikw sandbox trigger payment_failed \
  --payment-intent pi_abc123 \
  --failure-reason insufficient_funds

Simuler un payout réussi

ikw sandbox trigger payout_paid --payout po_xyz789

Simuler un payout échoué

ikw sandbox trigger payout_failed \
  --payout po_xyz789 \
  --failure-code provider_error \
  --failure-message "Recipient wallet not found"

Options

Flag	Description
--payment-intent <id>	Identifiant public du payment intent (pi_...)
--payout <id>	Identifiant public du payout (po_...)
--failure-reason <text>	Raison de l’échec du paiement
--failure-code <code>	Code d’échec du payout
--failure-message <text>	Message d’échec du payout

Workflow typique

Combinez les déclencheurs sandbox avec le listener webhook pour une boucle complète de test local :

# Terminal 1: Écouter les webhooks
ikw webhooks listen --port 4242

# Terminal 2: Créer et déclencher des événements
ikw payments create --amount 5000 --currency XOF --json > /tmp/pi.json
PI_ID=$(cat /tmp/pi.json | jq -r '.id')

ikw sandbox trigger payment_succeeded --payment-intent $PI_ID
# → Le terminal 1 affiche l’événement webhook payment_intent.succeeded

astuce

Les déclencheurs sandbox contournent le flux réel du provider de paiement. Ils simulent directement le callback qui viendrait normalement d’Orange Money, MTN MoMo, etc.