Intégration

EHOPAY : Simplifiez vos Paiements en Ligne

Créez votre compte en quelques étapes simples et commencez à explorer un monde de possibilités en ayant accès à des outils personnalisés.
Récupérez vos clés API et accédez à nos services . Ce processus est rapide et sécurisé, vous permettant de connecter vos applications à nos services sans tracas.
Intégrez notre API sur vos plateformes ou dans vos applications et Offrez plusieurs options de paiement, toutes sécurisées à vos clients, rendant ainsi les paiements très fluide.
Transparence totale sur votre compte après chaque paiement. Dès qu'une transaction est effectuée, toutes les informations sont mises à jour instantanément.

Intégrez EHOPAY API facilement.

Notre API REST vous permet d'intégrer EHOPAY quel qu'en soit votre language ou votre environnement.
.
.
.
PHP

     // 1ère étape : créer la session de paiement DEPUIS VOTRE SERVEUR (jamais depuis le navigateur)
     // POST https://ehopay.com/initiate-payment  —  en-tête Authorization: Basic base64(client_secret:client_id)
     // Guide complet : authentification, IPN signé, idempotence, exemples PHP, Laravel, Node.js, mobile

     $body = json_encode([
     'amount' => '1500',                                             // Montant de la commande (500 à 1 000 000 XOF)
     'currency' => 'XOF',                                            // Devise
     'method' => 'MOMOBENIN',                                        // Moyens proposés au Bénin
     'merchant_uuid' => 'VOTRE_MERCHANT_UUID',                        // Identifiant marchand
     'success_url' => 'https://votre-site-web.com/merci',             // Retour après paiement
     'cancel_url' => 'https://votre-site-web.com/panier',             // Retour après annulation ou échec
     'ipn_url' => 'https://votre-site-web.com/ehopay/ipn',            // Notification signée (HTTPS)
     ]);

     $ch = curl_init('https://ehopay.com/initiate-payment');
     curl_setopt_array($ch, [
         CURLOPT_POST => true, CURLOPT_POSTFIELDS => $body, CURLOPT_RETURNTRANSFER => true,
         CURLOPT_HTTPHEADER => [
             'Content-Type: application/json', 'Accept: application/json',
             'Authorization: Basic ' . base64_encode(getenv('EHOPAY_CLIENT_SECRET') . ':' . getenv('EHOPAY_CLIENT_ID')),
             'Idempotency-Key: commande-1234',                                // Une clé unique par commande
         ],
     ]);                                                                      // Vérification TLS active : ne jamais la désactiver
     $response = json_decode(curl_exec($ch), true);
     curl_close($ch);

     //2ème étape : rediriger le client vers approvedUrl (ou l'ouvrir en fenêtre modale avec ehopay-checkout.js)
     {
         "status": "success",
         "message": "Payment URL generated successfully",
         "data": {
            "approvedUrl": "https://ehopay.com/merchant/payment?grant_id=34647186&token=3BC5zwVoT1evQyGgEfiF",
            "grant_id": 34647186,
            "urltoken": "3BC5zwVoT1evQyGgEfiF",
            "transactionuuid": "357E864E1A9D4",   // Référence de la commande chez EhoPay : à conserver
            "amount": "1500", "currency": "XOF"
         }
     }
     // La commande n'est validée que sur l'IPN signé (en-tête X-Ehopay-Signature) ou la consultation du statut.

     //3ème étape 
     //Vérification du paiement 
     //Envoyer une requête GET à https://ehopay.com/api/verification-payment/$grant_id/$urltoken/$transactionuuid
     //Le serveur vous retourne pour une transaction reussie
     {
         "StatusCode": 200,
         "message": "Your transaction is done, Please Check Status in data field",
         "status": "success",
         "data": {
            "id": 454,
            "merchant_id": 17,
            "gateway_reference": "34c3df31-bdb4-430e-96eb-22a40d50dbe1",
            "order_no": "",
            "item_name": "",
            "uuid":"b7f16ae3-2a6b-496a-ad9d-c171c1fbba8a",
            "amount": "100.00",
            "total": "102.00",
            "status": "SUCCESSFUL",
            "created_at":"2023-01-17T15:29:21.000000Z" ,
            "updated_at":"2023-01-17T15:29:49.000000Z" 
         }
     }

      //ou pour une transaction en attente 
      {
         "StatusCode": 203,
         "message": "Your transaction is pending or expired, Your customer may not have paid or cancelled",
         "status": "success"
      }

         

Simplifiez vos transferts d'argent et profitez de la tranquillité d'esprit que vous méritez.


Rejoignez nous