API Recharge Crédit
API permettant de recharger le crédit mobile
L' API est appelée par l'url "https://mactopup.com/api/make_topup" stocké dans la variable $base_url
```php
<?php
$base_url = "https://mactopup.com/api/make_topup";
$fields = array(
"operatorId" => "535", // L'identifiant de l'opérateur
"amount" => "5800", // à remplacer par le montant de recharge
"phone" => "44xxxxxxxx", // à remplacer par le numero de téléphone
"isocode" => "GB", // à remplacer par l'iso code de votre pays
"token" => "MACTOPUP_xxxxxxxxxxxxxxxxx", // à remplacer par votre token
);
$curl_options = array(
CURLOPT_URL => $base_url,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => http_build_query( $fields ),
CURLOPT_HTTP_VERSION => 1.0,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HEADER => false
);
$curl = curl_init();
curl_setopt_array( $curl, $curl_options );
$result = curl_exec( $curl );
curl_close( $curl );
$response = json_decode($result);
echo "<pre>";
var_dump($response);
echo "</pre>";
?>
```
$base_url
: Cette variable contient l'URL de l'API à laquelle les requêtes POST seront envoyées pour effectuer la recharge de crédit.
$fields
: Il s'agit d'un tableau associatif qui contient les paramètres nécessaires pour effectuer la recharge. Vous devez remplacer les valeurs de ces paramètres par les valeurs spécifiques de votre cas d'utilisation :
"operatorId"
: L'identifiant de l'opérateur mobile auprès duquel la recharge doit être effectuée."amount"
: Le montant de recharge à appliquer au numéro de téléphone spécifié."phone"
: Le numéro de téléphone pour lequel la recharge de crédit doit être effectuée."isocode"
: Le code ISO du pays du numéro de téléphone (par exemple, "GB" pour le Royaume-Uni)."token"
: Le token d'authentification fourni par MACTOPUP pour accéder à l'API. Vous devez remplacer cette valeur par le token qui vous a été attribué.
Lors de l'intégration de cette API dans votre propre application, assurez-vous de remplacer les valeurs spécifiées dans $fields
par les informations pertinentes pour votre cas d'utilisation. Vous devez également gérer les erreurs et les cas d'utilisation spécifiques de votre application en conséquence.
La réponse de l'API lorsque la requête est bien exécutée:
Status code : SUCCESSFUL (200)
{"success":
{
"status_transaction":"SUCCESSFUL",
"MACTOPUP_TransactionId":14874457,
"Recipient_OperatorTransactionId":"7297929551:OrderConfirmed",
"Operator_Name":"EE PIN England",
"Recipient_PhoneNumber":447951302147,
"Country_Code":"GB",
"Amount_Requested":217,
"Transaction_fees":3.255,
"currency":"XOF",
"Date_Of_Transaction":"2023-08-01 08:13:39"
}
}
+QUELQUES ERREURS
TOKEN_IS_REQUIRED
Statut code: 422
Votre champ token est vide
INVALID_ACCOUNT ou SUSPENDED_ACCOUNT
Status code: 403
Votre compte est inactif ou invalide, absence d'activité pendant une longue période.
PHONE_NUMBER_REQUIRED
Status code: 400
Le champ numéro de téléphone est vide
COUNTRY_CODE_REQUIRED
Status code: 400
Le champ iso code est requis
OPERATOR_ID_REQUIRED
Status code: 400
Le champ identifiant operateur est requis
AMOUNT_REQUIRED
Status code: 400
Le montant de recharge est requis
INSUFFICIENT_FUNDS
Status code: 403
Votre solde est insuffisant pour effectuer cette opération
TOKEN_INVALID
Votre token est incorrect.
INVALID_RECIPIENT_PHONE
Status code: 422
Le numéro de téléphone de votre destinataire est invalide.
INVALID_INPUT_PROVIDED
Status code: 422
Les valeurs des champs fournies sont mal formatées.
INVALID_PHONE_NUMBER
Status code: 422
Le numéro de téléphone fourni est incorrect.
PHONE_RECENTLY_RECHARGED
Status code: 422
Ce numéro de l'operateur refuse les recharges prépayées
TOPUP_TRANSACTION_FAILED
Status code: 422
La transaction de recharge crédit mobile a échoué.
TRANSACTION_CANNOT_BE_PROCESSED_AT_THE_MOMENT
Votre transaction ne peut pas aboutir actuellement pour des raisons propres à l'opérateur.
INVALID_AMOUNT_FOR_OPERATOR
Status code: 422
Cette erreur s'affiche souvent lorsque l'opérateur dispose des montants de recharges fixes et que vous entrez autre valeur de recharges que celles définies par l'opérateur.
Cela peut également être la cause d'une tentative de recharge inférieure à celle définie par cet opérateur.
INVALID_AMOUNT
Status code: 422
Le montant entré est invalide.
COUNTRY_NOT_SUPPORTED
Status code: 422
Nous ne prenons pas en charge l'opérateur de ce pays.
INACTIVE
Status code: 422
Cet opérateur n'est pas actuellement actif
OPERATOR_NOT_IN_SERVICE
Status code: 422
Cet opérateur réseau n'est plus en service.
OPERATOR_UNAVAILABLE_OR_CURRENTLY
Status code: 422
Cet opérateur est momentanément indisponible.
INSUFFICIENT_BALANCE
Status code: 422
Votre solde est insuffisant.
ERROR_MAINTENANCE
Status code: 422
Une erreur interne au serveur ou une maintenance
INTERNAL_ERROR_UNABLE_TO_MAKE_TOPUP
Status code: 500
Une erreur interne du serveur, Opération de recharge a échouée
METHOD_NOT_ALLOWED
Cette erreur survient lorsque vous essayez d'accéder à l'API directement via le lien: https://mactopup.com/api/make_topup sans soumettre une requête POST
Last updated