Skip to main content

​
Intégration API

Le Lien de paiement utilise des endpoints API HUB2. Les endpoints disponibles sont listés dans la documentation suivante :

API Payment Links

​
Authentification

Votre intégration utilise les mêmes clés API HUB2 pour l’authentification mais la clé doit avoir des permissions de création de paiement :
  • Api.payment_create
  • Api.payment_intent_create
  • Api.payment_intent_read
  • Api.payment_intent_auth_create
  • Api.payment_fees_read

Configuration des permissions

​
Endpoints API

Le Lien de paiement utilise des endpoints de création et de lecture similaires aux endpoints classiques

​
Lien de Paiement

  • POST /payment-links/ - Créer un lien de paiement en definissant les moyens de paiements necessaires. Le paiement et l’intention de paiement seront pris en charge en fonction du parcours du client. Ci-après un exemple.
curl --location 'https://api.hub2.io/payment-links' \
--header 'environment: sandbox' \
--header 'merchantId: [REDACTED]' \
--header 'Content-Type: application/json' \
--header 'ApiKey: [REDACTED]' \
--data '{
    "purchaseReference": "<YOUR_INTERNAL_CUSTOMER_REFERENCE>",
    "description":"Payment Links are the fastest way to start accepting payments from your customers.",
    "amount": 500,
    "currency": "XOF",
    "type":"single_use",
    "expirationDate": "2025-10-28T20:30:00",
    "paymentMethods": [
        "mobile_money"
    ],
    "country": "CI",
    "providers": [
        "Orange",
        "Wave",
        "MTN",
        "Moov"
    ],
    "successUrl":"pay.hub2.io/success",
    "failureUrl":"pay.hub2.io/failure"
    
}'
  • PATCH /payment-links/{id}/close - Fermer un lien de paiement avant expiration
  • GET /payment-links - Lister les liens de paiement créés
  • GET /payment-links/{id} - Retrouver un lien de paiement spécifique et afficher les paiements associés

​
Webhooks

Ceci utilise les mêmes webhooks que les endpoints de paiement. Si vous avez déjà configuré des webhooks pour les paiements/, aucune étape supplémentaire n’est requise. Sinon, consultez :

Guide d'intégration des Webhooks