Aller au contenu principal

Payment Links

Les payment links vous permettent d’exposer un point d’entrée de paiement hébergé sans construire votre propre UI de checkout.

Familles de routes implémentées​

Famille de routes authentifiée :

  • POST /api/v1/payment_links
  • GET /api/v1/payment_links/{id}
  • POST /api/v1/payment_links/{id}/deactivate

Route d’accès publique :

  • GET /pay/{slug}

La route publique résout le lien et redirige le client vers une URL de checkout session.

POST /api/v1/payment_links

Authentification :

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

Exemple :

curl -X POST https://api.ikawaari.com/api/v1/payment_links \
  -H "Authorization: Bearer ik_test_or_app_token" \
  -H "Content-Type: application/json" \
  -d '{
    "line_items": [
      {
        "name": "Consultation fee",
        "amount": 25000,
        "currency": "XOF",
        "quantity": 1
      }
    ],
    "after_completion": {
      "type": "redirect",
      "redirect": {
        "url": "https://yoursite.com/thank-you"
      }
    }
  }'
GET /api/v1/payment_links/{id}
POST /api/v1/payment_links/{id}/deactivate

Accès public côté client​

GET /pay/{slug}

Cette route publique résout le slug, crée ou récupère la checkout session associée, puis redirige le client vers l’URL de checkout hébergé.

Note opérationnelle​

Les payment links font partie du domaine checkout implémenté et sont étroitement liés à :

  • les checkout sessions hébergées
  • la gestion des payment links dans le dashboard marchand
  • l’accès public au checkout via des points d’entrée basés sur slug

Sections liées​