Créer une cléCopier le lien de la section

Ouvrir le tableau de bord 221 Pay (créez un compte si nécessaire), puis Développeurs > Clés API : créer une clé avec la portée payments. Le lien ouvre le tableau de bord de l’environnement qui sert cette documentation, celui de l’URL de base ci-dessous. Une clé de test commence par sk_221_pay_test_ ; son secret n’est affiché qu’une fois.

export API_KEY="sk_221_pay_test_…"
export API_URL="<URL de base ci-dessous>"

Créer un paiementCopier le lien de la section

curl -X POST "$API_URL/v1/payments" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Idempotency-Key: commande-1042" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "5000",
    "currency": "XOF",
    "rail": "sn_wave",
    "merchant_reference": "commande-1042",
    "return_url": "https://boutique.example/paiement/retour",
    "customer_phone": "77 123 45 67"
  }'

Rediriger le client vers checkout_url, ou suivre next_action.

Recevoir le résultatCopier le lien de la section

À la confirmation, 221 Pay envoie l’événement payment.succeeded aux points de terminaison webhook du projet. Le paiement se relit aussi à tout moment :

curl "$API_URL/v1/payments/$PAYMENT_ID" -H "Authorization: Bearer $API_KEY"

status vaut alors confirmed ; fee et net indiquent les frais et le montant crédité.