API Reference

API REST complète

Une API RESTful simple et bien documentée pour intégrer les paiements Mobile Money.

Authentification sécurisée

API Keys avec permissions granulaires et rotation automatique.

Performance optimale

Temps de réponse < 200ms avec CDN global.

Bien documentée

Exemples dans tous les langages populaires.

URL de base

https://api.simiz.io/api/v1

Authentification

Toutes les requêtes doivent inclure votre clé API dans le header Authorization:

Authorization: Bearer sk_live_xxx

⚠️ Gardez vos clés secrètes

Ne partagez jamais vos clés API côté client. Utilisez-les uniquement côté serveur.

Endpoints principaux

POST/api/v1/paymentsCréer un nouveau paiement

GET/api/v1/payments/:idRécupérer un paiement

POST/api/v1/payments/:id/confirmConfirmer un paiement

POST/api/v1/checkout/sessionsCréer une session de checkout

GET/api/v1/checkout/sessions/:idRécupérer une session

POST/api/v1/webhooksRecevoir les notifications

Exemple de requête

Request

curl -X POST https://api.simiz.io/api/v1/payments \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "550e8400-e29b-41d4-a716-446655440000",
    "amount": 25000,
    "currency": "XAF",
    "returnUrl": "https://merchant.com/success",
    "cancelUrl": "https://merchant.com/cancel",
    "description": "Commande #1234"
  }'

Response200 OK

{
  "id": "pay_abc123",
  "object": "payment",
  "amount": 25000,
  "currency": "XAF",
  "status": "pending",
  "returnUrl": "https://merchant.com/success",
  "cancelUrl": "https://merchant.com/cancel",
  "createdAt": "2024-03-15T10:30:00Z"
}

Préférez utiliser un SDK ?

Nous proposons des SDKs officiels pour les langages les plus populaires.

Prêt à intégrer ?

Créez votre compte et obtenez vos clés API en quelques minutes.