Documentation API

Intégrez IZIflow Pay à votre application pour accepter des paiements par carte (Moneris, Canada) et, prochainement, par Mobile Money en Afrique. Chaque section ci-dessous peut être testée en direct contre l'environnement sandbox ou production.

Introduction

L'API IZIflow Pay expose des endpoints REST simples pour créer un lien de paiement (checkout hébergé) ou déclencher directement un paiement carte depuis votre backend.

💡

URL de base de l'API

Production : https://iziflow.ca
Sandbox : https://iziflow.ca

Authentification

Chaque requête doit inclure votre api_key et votre user_id (fournis depuis votre tableau de bord) dans le corps de la requête.

⚠️

Sécurité de la clé API

Ne partagez jamais votre clé API et n'appelez jamais ces endpoints depuis du code exécuté dans le navigateur du client final — passez toujours par votre propre backend.

Moyens de paiement

Statut actuel des canaux de paiement supportés :

Disponible

Carte (Visa / Mastercard)

payment_method: card

Bientôt

Mobile Money (Orange, MTN...)

payment_method: mobile

Valider une clé API

Vérifie qu'une clé API est active et associée à un compte actif avant d'afficher un formulaire de paiement.

POST

/api/iziflow/validate-key

Paramètre	Type	Requis	Description
`api_key`	string	Oui	Votre clé API
`user_id`	integer	Oui	Identifiant de votre compte

Réponse de succès

{
  "valid": true,
  "merchant_name": "Ma Boutique",
  "currency": "CAD",
  "environment": "sandbox"
}

Tester cet endpoint

api_key

user_id

Générer un lien de checkout

Crée un lien de paiement hébergé (page carte + bientôt mobile money) à envoyer à votre client. Le lien contient un jeton chiffré valable 30 minutes — aucune donnée sensible n'apparaît en clair dans l'URL.

POST

/api/iziflow/checkout-link

Paramètre	Type	Requis	Description
`api_key`	string	Oui	Votre clé API
`user_id`	integer	Oui	Identifiant de votre compte
`amount`	number	Oui	Montant en dollars (ex: 25.00)
`order_id`	string	Non	Référence de commande interne
`customer_email`	string	Non	Email du client

Réponse de succès

{
  "success": true,
  "checkout_url": "https://.../checkout?token=eyJpdiI6...",
  "expires_in": 1800
}

Tester cet endpoint

api_key

user_id

amount

order_id

Effectuer un paiement directement

Déclenche immédiatement un paiement (sans page de checkout hébergée) — utile si vous avez votre propre formulaire de paiement.

POST

/api/iziflow/charge

Paramètre	Type	Requis	Description
`api_key`	string	Oui	Votre clé API
`user_id`	integer	Oui	Identifiant de votre compte
`amount`	number	Oui	Montant en dollars
`payment_method`	string	Oui	`card` ou `mobile`
`credit_card`	string	Si carte	Numéro de carte (13-19 chiffres)
`expiry_month`	string	Si carte	MM
`expiry_year`	string	Si carte	YY
`cvd`	string	Recommandé	Code CVV
`order_id`	string	Non	Référence de commande

💳

Cartes de test (sandbox)

Visa : 4242424242424242 — Expiration : n'importe quelle date future (ex: 12/29) — CVD : n'importe quel 3 chiffres (ex: 123)

Tester cet endpoint

api_key

user_id

amount

payment_method

credit_card

expiry_month

expiry_year

cvd

order_id

Gestion des erreurs

Toutes les réponses d'erreur suivent la même forme :

{
  "success": false,
  "message": "Clé API invalide ou compte inactif.",
  "errors": []
}

Code	Signification
`200`	Requête traitée avec succès
`401`	Clé API invalide, expirée, ou compte inactif
`403`	Paiements non activés sur ce compte
`422`	Paramètres invalides ou paiement refusé