> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hub2.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Intégration

> Apprenez comment intégrer le lien de paiement dans votre application

## Intégration API

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

<Card title="API Payment Links" icon="link" href="https://api.hub2.io/docs#/Payment%20Links" arrow="true" cta="Vers la documentation de l'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`

<Card title="Configuration des permissions" icon="link" href="/integration/fr/payment-links/payment-links_setup#configuration-dans-le-tableau-de-bord-hub2" arrow="true" cta="Vers le guide configuration des permissions pour la clé API" />

## 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.

<CodeGroup>
  ```bash Curl {1} theme={null}
  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"
      
  }'
  ```
</CodeGroup>

* `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 :

<Card title="Guide d'intégration des Webhooks" icon="link" href="https://docs.hub2.io/integration/fr/webhooks/webhooks_overview" arrow="true" cta="Vers le guide d'intégration des Webhooks" />