Checkout Sessions

Ikawaari Checkout combine une famille de routes de checkout session authentifiée avec une famille de routes checkout publiques utilisées par l’expérience de checkout hébergé.

Familles de routes implémentées

Routes authentifiées :

• POST /api/v1/checkout/sessions
• GET /api/v1/checkout/sessions/{id}

Routes checkout publiques utilisées par la page hébergée :

• GET /api/checkout/{sessionId}
• POST /api/checkout/{sessionId}/pay

Créer une checkout session

POST /api/v1/checkout/sessions

Authentification :

• ApiKey ou AppToken
• scope d’écriture pour les paiements

Exemple :

curl -X POST https://api.ikawaari.com/api/v1/checkout/sessions \
  -H "Authorization: Bearer ik_test_or_app_token" \
  -H "Content-Type: application/json" \
  -d '{
    "line_items": [
      {
        "name": "Premium Plan",
        "amount": 50000,
        "currency": "XOF",
        "quantity": 1
      }
    ],
    "mode": "payment",
    "success_url": "https://yoursite.com/success?session_id={CHECKOUT_SESSION_ID}",
    "cancel_url": "https://yoursite.com/cancel"
  }'

Récupérer une checkout session

GET /api/v1/checkout/sessions/{id}

Utilisez cette route pour récupérer l’objet session autoritatif après sa création.

Flux de checkout hébergé public

Le frontend checkout utilise des routes publiques sous api/checkout.

Obtenir les détails de session pour la page hébergée

GET /api/checkout/{sessionId}

Soumettre le paiement depuis la page hébergée

POST /api/checkout/{sessionId}/pay

Cette route est publique car elle est consommée par la page de checkout elle-même, et non par les backends marchands.

Réponse typique

{
  "id": "cs_abc123",
  "url": "https://checkout.ikawaari.com/cs_abc123",
  "status": "open",
  "payment_intent": "pi_xyz789",
  "expires_at": 1708387200
}

Redirigez le client vers url pour finaliser le paiement.

Note d’intégration

Ne documentez pas le checkout comme étant uniquement /v1/checkout/sessions.

L’expérience implémentée utilise à la fois :

• la création et la récupération marchandes authentifiées via api/v1/checkout/sessions
• les opérations publiques de checkout hébergé via api/checkout/*

Modes de checkout

Mode	Description
payment	Paiement ponctuel
subscription	Abonnement récurrent

Sections liées

• Payment Links
• Payment Intents
• Familles de routes