Passerelles de Paiement Codinfy

1. Vue d'ensemble — Intégrations natives

Codinfy inclut nativement 5 passerelles préconfigurées. Les clés sont gérées depuis Admin > Paramètres > APIs — jamais hardcodées dans le code.

2. CinetPay — Configuration détaillée

CinetPay est la passerelle pan-africaine de référence en Afrique francophone. Elle supporte Mobile Money, carte bancaire et wallet.

Clés à renseigner dans Admin > Paramètres > APIs

URL Webhook à déclarer dans CinetPay

https://votredomaine.com/api/payments/webhooks/cinetpay

Flux de paiement

1. Codinfy appelle POST /v2/payment → CinetPay retourne un payment_url.
2. Le client est redirigé vers le payment_url CinetPay pour finaliser.
3. CinetPay envoie un webhook POST vers l'URL déclarée.
4. Codinfy valide le HMAC x-token, vérifie via /v2/payment/check et active la licence.

Vérification de statut (réconciliation manuelle)

POST https://api-checkout.cinetpay.com/v2/payment/check
{
  "apikey": "{cinetpay_api_key}",
  "site_id": "{cinetpay_site_id}",
  "transaction_id": "{gateway_ref}"
}

3. TouchPay / InTouch — Configuration détaillée

TouchPay (InTouch Group) supporte les paiements Mobile Money directs : Orange Money, MTN MoMo, Moov Money et d'autres opérateurs selon les pays.

Clés à renseigner

Codes service par opérateur

Flux de paiement (payin direct)

1. Le client fournit son numéro Mobile Money et choisit l'opérateur.
2. Codinfy appelle PUT /transaction avec le numéro et le serviceCode.
3. InTouch envoie une demande USSD au téléphone du client.
4. Le client confirme sur son téléphone → webhook Codinfy reçu.
5. Codinfy valide le secret et active la licence.

Vérification de statut

GET {touchpay_base_url}/transaction/{transaction_id}
Authorization: Basic {base64(login:password)}

4. KKiaPay — Configuration détaillée

KKiaPay propose un widget JavaScript embarqué, compatible avec les hébergements mutualisés sans backend Node.js. Le bridge Codinfy gère la page locale.

Clés à renseigner

URL Webhook à déclarer dans KKiaPay

https://votredomaine.com/api/payments/webhooks/kkiapay

Flux de paiement

1. Le client clique "Payer" → Codinfy redirige vers /checkout/kkiapay/{invoice}.
2. La page locale charge le widget JS KKiaPay avec la clé publique et le montant.
3. Le client paie dans le widget → callback navigateur + webhook serveur.
4. Codinfy valide le header x-kkiapay-secret et active la licence.

5. Stripe — Configuration

Stripe est la référence mondiale pour les paiements par carte, SEPA, Apple Pay et Google Pay.

Clés à renseigner

URL Webhook à déclarer dans Stripe Dashboard

https://votredomaine.com/api/payments/webhooks/stripe
Événements : checkout.session.completed, payment_intent.succeeded, charge.refunded

Flux de paiement

1. Codinfy crée une Checkout Session Stripe via l'API.
2. Le client est redirigé vers la page Stripe hébergée.
3. Stripe envoie un webhook checkout.session.completed.
4. Codinfy valide la signature Stripe et active la licence.

6. PayPal — Configuration

URL Webhook

https://votredomaine.com/api/payments/webhooks/paypal
Événements : PAYMENT.CAPTURE.COMPLETED, PAYMENT.CAPTURE.REFUNDED

7. Routes techniques — Checkout & Webhooks

8. Afrique de l'Ouest — Passerelles additionnelles

9. Afrique Centrale & de l'Est (partiel)

10. Afrique de l'Est

11. Afrique du Nord & Moyen-Orient

12. Afrique Australe

13. Mondial — Passerelles internationales

14. Paiements Crypto

15. Bonnes pratiques d'intégration