Transaction LINK API

L’API Transaction LINK permet de générer un lien de paiement multi-canaux (Orange Money (Centrafrique), Visa / Mastercard).

format

Ce lien redirige généralement l’utilisateur vers une page de paiement LuckyFastPay où il finalise la transaction.

Comportement selon le service

WEB (Orange Money (Centrafrique))

Le lien redirige vers une page de paiement web.
Le champ customer_account_number est optionnel.
Service destiné aux navigateurs (mobile ou desktop).

VISA_MASTERCARD

Le lien ouvre un formulaire Visa/Mastercard sur LuckyFastPay.
Le champ customer_account_number est requis (identifiant client/carte).
Utilisé pour des paiements bancaires en ligne.

RESTLINK

Le lien ne redirige pas vers une page web.
À l’ouverture, un prompt de mot de passe s’affiche directement sur le téléphone du client.
Le champ customer_account_number est requis.
Idéal pour des intégrations mobiles silencieuses.

Récapitulatif des champs obligatoires

Service	Redirection	`customer_account_number`	Comportement
`WEB`	Oui	Non	Redirection vers une page de paiement LuckyFastPay
`VISA_MASTERCARD`	Oui	Oui	Redirection vers un formulaire bancaire
`RESTLINK`	Non	Oui	Prompt de mot de passe sur le téléphone

Cas d’usage

Envoyer un lien de paiement à l’utilisateur
Permettre le paiement en 1 clic depuis un site marchand
Afficher un formulaire Visa/Mastercard
Déclencher une demande USSD directe (RESTLINK) sans page web

En-têtes

Méthode POST

Url de base https://api.luckyfastpay.pro

Chemin /{code-url}/link

Encodage application/json

En-têtes requis

Content-Type: application/json
X-Secret: sk_live_xxx
X-Callback-MediaType: application/json (optionnel)

À propos de X-Callback-MediaType

Spécifie le format du callback envoyé par LuckyFastPay en fin de transaction.

`application/json` (par défaut)
`application/xml` (si souhaité)
`text/xml` (si souhaité)

Cet en-tête s’applique uniquement aux transactions de type PAYMENT.

Paramètres

Nom	Emplacement	Type	Obligatoire	Description
`code-url`	path	string	Oui	Code URL marchand
`X-Secret`	header	string	Oui	Votre clé secrète
`X-Callback-MediaType`	header	string	Non	Format de données de l'objet callback

Paramètres requis (JSON)

Nom	Type	Obligatoire	Description
`agent`	string	Non	Identifiant de l'agent.
`amount`	number	Oui	Montant de la transaction.
`product`	string	Non	Libellé ou nom du produit affiché au client.
`reference`	string	Oui	Référence unique de la transaction côté marchand.
`service`	string	Non	Service utilisé par le lien: WEB, VISA_MASTERCARD ou RESTLINK.
`callback_url_code`	string	Non	Code de l’URL de callback appelée en fin de transaction.
`customer_account_number`	string	Non	Numéro ou identifiant client. Requis selon le service utilisé.
`operation_account_code`	string	Oui	Code du compte d'opération marchand.
`transaction_type`	string	Oui	Type de transaction, généralement PAYMENT.
`owner_charge`	string	Oui	Indique qui supporte les frais LuckyFastPay.
`operator_owner_charge`	string	Non	Indique qui supporte les frais opérateur.
`free_info`	string	Non	Information libre renvoyée dans le cycle de transaction si disponible.
`failed_redirection_url_code`	string	Oui	Code de l’URL de redirection utilisée en cas d’échec.
`success_redirection_url_code`	string	Oui	Code de l’URL de redirection utilisée en cas de succès.

Exemples

Exemple de requête : service WEB

{
  "agent" "AGENT-1",
  "amount" 600,
  "reference" "5632907",
  "service" "WEB",
  "callback_url_code" "HPPPY",
  "customer_account_number" "074140864",
  "operation_account_code" "ACC_6756EE73253F6",
  "transaction_type" "PAYMENT",
  "owner_charge" "MERCHANT",
  "operator_owner_charge" "MERCHANT",
  "failed_redirection_url_code" "FAIL123",
  "success_redirection_url_code" "OK123"
}

Exemple de requête : service VISA_MASTERCARD

{
  "service" "VISA_MASTERCARD"
}

Exemple de requête : service RESTLINK

Ce mode ne redirige pas ; il déclenche un prompt immédiat sur le téléphone.

{
  "service" "RESTLINK"
}

Exemple de réponse

{
  "status" "PENDING",
  "status_code" "200",
  "reference" "5632907",
  "url" "https://api.luckyfastpay.pro/transaction-link/XYZ/payment"
}