FluxLink
FluxLink permet de créer des liens de paiement que vous partagez à vos clients (e-mail, SMS, réseaux sociaux). Le client paie sur une page FluxxPay sans intégrer un tunnel de paiement complet.
Base URL : https://api.fluxxpay.com/api/v1/payment-links/
Prérequis
- Name
Compte marchand- Description
Compte FluxxPay validé.
- Name
Authentification- Description
Authorization: Bearer <votre_clé_api>sur chaque requête.
Créer un lien
Corps de la requĂŞte (principaux champs)
- Name
amount- Type
- integer
- Description
Montant en centimes (ex.
10000= 100 FCFA).
- Name
currency- Type
- string
- Description
Code devise (
XOF, etc.).
- Name
title- Type
- string
- Description
Titre affiché au payeur.
- Name
description- Type
- string
- Description
Description du paiement.
- Name
redirect_url- Type
- string
- Description
URL de redirection après succès (optionnel).
- Name
allowed_payment_methods- Type
- array
- Description
Ex.
["mobile_money"]pour limiter aux moyens autorisés.
- Name
expires_at- Type
- string
- Description
Date d'expiration ISO 8601 (optionnel).
RequĂŞte
curl -X POST 'https://api.fluxxpay.com/api/v1/payment-links/' \
-H 'Authorization: Bearer <votre_clé_api>' \
-H 'Content-Type: application/json' \
-d '{
"amount": 10000,
"currency": "XOF",
"title": "Facture #2024-042",
"description": "Prestation conseil",
"redirect_url": "https://example.com/merci"
}'
RĂ©ponse
{
"id": "uuid-du-lien",
"title": "Facture #2024-042",
"amount": 10000,
"currency": "XOF",
"status": "ACTIVE",
"payment_url": "https://pay.fluxxpay.com/l/..."
}
Le champ exact payment_url (ou équivalent) dépend de la réponse sérialisée — utilisez l'URL de paiement retournée par l'API pour partager le lien au client.
Récupérer un lien
DĂ©tail
curl -X GET 'https://api.fluxxpay.com/api/v1/payment-links/<id>/' \
-H 'Authorization: Bearer <votre_clé_api>'
Cas d'usage
- Vente ponctuelle ou facture
- Paiement de service
- Billet ou inscription
- Lien partagé en one-to-one