// 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"
}