Première transaction test

Une fois votre compte Lucky FastPay créé et vos informations de test récupérées (clé secrète, compte d’opération, URLs), vous pouvez effectuer votre première transaction de test.

Objectif

Simuler une transaction réelle dans un environnement de test, afin de :

• Vérifier que votre appel API est correctement formaté
• Comprendre la réponse de Lucky FastPay (succès, erreur, callback)
• Réaliser les 2 transactions succès et 2 échecs nécessaires pour passer en production
• Vérifier que votre appel API est correctement formaté
• Comprendre la réponse de Lucky FastPay (succès, erreur, callback)
• Réaliser les 2 transactions succès et 2 échecs nécessaires pour passer en production

Exemple de transaction test (PAYMENT)

curl --location 'https://api.luckyfastpay.pro/XXXXXXXXXXXXX/rest' \
--header 'X-Secret: sk_test_xxxxx' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data {
    "agent": "AGENT-1",
    "amount": 200,
    "callback_url_code": "XXXXX",
    "customer_account_number": "074XXXXXX",
    "merchant_operation_account_code": "ACC_TEST_001",
    "transaction_type": "PAYMENT",
    "owner_charge": "MERCHANT",
    "owner_charge_operator": "MERCHANT",
    "free_info": "INFORMATION",
    "product": "PRODUIT XXXXX",
    "reference": "TEST_REF_001",
    "service": "RESTFUL"
}

Résultat attendu (transaction réussie)

{
  "status": "PENDING",
  "status_code": "200",
  "operator": "AIRTEL_MONEY",
  "reference_id": "PAY240420250001",
  "merchant_reference_id": "TEST_REF_001",
  "merchant_operation_account_code": "ACC_TEST_001",
  "message": "Votre demande de paiement TEST_REF_001 a été initiée avec succès et est en cours de traitement. Veuillez patienter le statut définitif de votre transaction"
}

Le statut PENDING est normal pour les paiements : la confirmation finale viendra via un callback envoyé par Lucky FastPay.

Réception du callback (asynchrone)

Une fois la transaction confirmée, Lucky FastPay envoie un callback à l’URL configurée :

{
  "transactionId": "PAY240420250001",
  "merchantReferenceId": "TEST_REF_001",
  "status": "SUCCESS",
  "amount": 200,
  "customerID": "074XXXXXX",
  "fees": 5,
  "operator": "AIRTEL_MONEY"
}

Vous devez répondre avec un accusé de réception :

{
  "responseCode": 200,
  "transactionId": "PAY240420250001"
}

Simuler un échec

Pour tester un échec, utilisez un montant supérieur à 1000 XAF, par exemple :

"amount": 1500

Cela déclenchera une transaction refusée (status: FAILED) dans le callback envoyé, ce qui est requis pour la validation de votre intégration.

Conseils pratiques

• Utilisez des références uniques à chaque appel (champ "reference")
• Activez votre URL de callback dans l’espace marchand
• Consultez vos logs pour vérifier la réception des callbacks
• Vérifiez la structure JSON envoyée dans la requête