Aller au contenu principal

🚀 Démarrage Rapide

Bienvenue dans la documentation développeur d'Efaina ! Ce guide vous accompagne dans vos premiers pas pour intégrer notre solution de paiement en ligne.

Prérequis​

Avant de commencer, assurez-vous d'avoir :

  • Un compte Efaina actif
  • Un environnement de dĂ©veloppement (Node.js, Python, PHP, etc.)
  • Un outil pour tester les API (Postman, curl, etc.)

Étape 1 : Génération du Token d'Accès​

Important

La plupart des endpoints de l'API nécessitent un token d'accès pour l'authentification.

  1. Connectez-vous Ă  votre tableau de bord Efaina
  2. Accédez au menu Développeur > Clé API
  3. Générez un nouveau token d'accès
  4. Conservez-le en sécurité

Étape 2 : Création de votre Premier Wallet​

Un wallet (portefeuille virtuel) est nécessaire pour recevoir et gérer vos paiements.

Via l'Interface Web​

  1. Dans votre tableau de bord > Wallets
  2. Cliquez sur Créer un wallet

Via l'API​

curl --request POST \
    "https://efn.efaina.com/api/public/v1/wallets/store" \
    --header "Authorization: Bearer VOTRE_TOKEN" \
    --header "Accept: application/json" \
    --form "phone=0341234567"\
    --form "last_name=Randria"\
    --form "first_name=Lova"\
    --form "city=Antananarivo"\
    --form "address=Lot II B 23"\
    --form "company=MyCompany SARL"\
    --form "num_identity_card=101020304050"\
    --form "cash_out[method]=bank_transfer"\
    --form "cash_out[info][name]=Randria Lova"\
    --form "cash_out[info][phone]=0341234567"\
    --form "cash_out[info][rib]=architecto"\
    --form "cash_out[info][description]=Eius et animi quos velit et."\
    --form "cash_out[info][first_choice]=mobile_money"\
    --form "image_residence=@/tmp/phpq70EEF" \
    --form "image_identity_card=@/tmp/phpXgGzQH"

Étape 3 : Premier Paiement de Test​

Création d'un Checkout​

curl --request POST \
    "https://efn.efaina.com/api/public/v1/pay/create-checkout" \
    --header "Authorization: Bearer VOTRE_TOKEN" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"amount\": \"125000\",
    \"comment\": \"Invoice #INV-2024-001\",
    \"wallet_id\": \"a3bb189e-b1be-49d4-aec2-a9b02d7a5c20\",
    \"company\": \"MyCompany SARL\",
    \"return_urls\": {
        \"return_to_merchant_url\": \"https:\\/\\/merchant.example.com\\/payment\\/callback\"
    }
}"

Réponse Attendue​

{
  "checkout_url": "https://checkout.efaina.com/pay/abc123...",
  "reference": "CHK-ABC123"
}

Étape 4 : Configuration des Webhooks​

Pour recevoir les notifications en temps réel :

  1. Dans votre tableau de bord > DĂ©veloppeur > Webhooks
  2. Ajoutez votre URL d'endpoint (ex: https://api.votresite.com/webhooks/efaina)
  3. Générez un token de sécurité

Étape 5 : Test Complet​

  1. Initiez un paiement avec le checkout URL
  2. Simulez un paiement (utilisez les données de test en sandbox)
  3. Vérifiez les webhooks reçus
  4. Consultez l'historique des transactions

Prochaines Étapes​

Maintenant que vous avez les bases :

Conseil

Commencez toujours par l'environnement de test (sandbox) avant la production.