// 1ère étape
// Envoyer une Requête POST avec les paramètres suivants :
// amount (int , double) , currency (string) , method (string) , success_url (string), cancel_url (string), client_id (string), client_secret (string)
// à l'adresse du endpoint : https://merchant.cards.ehopay.com/api.php
// Exemple de Code PHP
header('Content-type: application/json');
$parameters = array(
'amount' => 100, //Montant de la transaction
'currency' => 'XOF', // Devise utilisée
'method' => 'Ehopay', // Nom de votre entreprise
'success_url' => 'https://votre-site-web.com/success.php', // Url de redirection pour transaction reussie
'cancel_url' => 'https://votre-site-web.com/echec.php', // Url de redirection pour après annulation ou echec
'client_id' => 'hh6TSq0KgsEoVN6M1tQLOyy7zqliY6', // Clé client Id du marchant
'client_secret' => 'Ux1vw0C238EoVEjtiIKdYwzN85kVIo7WWK7WqxmI8695DAXrfH9p21WqdKmAoyFmM19CMAXKzbu8FEodBW483rjVrJ8HvVHIOrgH', // Clé client secret du marchant
);
// Generate The Url (LIVE)
$endpoint = 'https://merchant.cards.ehopay.com/api.php';
$call = $endpoint . "?" . http_build_query($parameters);
// Send Request
$ch = curl_init();
curl_setopt($ch, CURLOPT_AUTOREFERER, TRUE);
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($ch, CURLOPT_URL, $call);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, TRUE);
$response = curl_exec($ch);
curl_close($ch);
echo var_dump($dd);
// $response contient la réponse retourner par le serveur
//2ème étape
// Vous recevrez une reponse similaire
{
"code": 200,
"data": {
"error": "ok",
"message": "Payment Initiated. Redirect to url",
"url": {
"approvedUrl": "https://ehopay.com/merchant/payment?grant_id=34647186&token=3BC5zwVoT1evQyGgEfiF", // Url de paiement sur lequel l'utlisateur sera redirigé
"grant_id": 34647186, // $grant_id => paramètre unique de l'Url de paiement
"urltoken": "3BC5zwVoT1evQyGgEfiF", // $urltoken => token de l'Url de paiement
"transactionuuid":"357e864e-1a9d-49e8-bf6a-cae5595f59ee" // $transactionuuid => identifiant unique de la transaction
}
}
}
//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": 405,
"message": "Your transaction is pending or expired, Your customer may not have paid or cancelled",
"status": "success"
}