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)

+QUELQUES ERREURS

Statut code: 422

Votre champ token est vide

Status code: 403

Votre compte est inactif ou invalide, absence d'activité pendant une longue période.

Status code: 400

Le champ numéro de téléphone est vide

Status code: 400

Le champ iso code est requis

Status code: 400

Le champ identifiant operateur est requis

Status code: 400

Le montant de recharge est requis

Status code: 403

Votre solde est insuffisant pour effectuer cette opération

Votre token est incorrect.

Status code: 422

Le numéro de téléphone de votre destinataire est invalide.

Status code: 422

Les valeurs des champs fournies sont mal formatées.

Status code: 422

Le numéro de téléphone fourni est incorrect.

Status code: 422

Ce numéro de l'operateur refuse les recharges prépayées

Status code: 422

La transaction de recharge crédit mobile a échoué.

Votre transaction ne peut pas aboutir actuellement pour des raisons propres à l'opérateur.

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.

Status code: 422

Le montant entré est invalide.

Status code: 422

Nous ne prenons pas en charge l'opérateur de ce pays.

Status code: 422

Cet opérateur n'est pas actuellement actif

Status code: 422

Cet opérateur réseau n'est plus en service.

Status code: 422

Cet opérateur est momentanément indisponible.

Status code: 422

Votre solde est insuffisant.

Status code: 422

Une erreur interne au serveur ou une maintenance

Status code: 500

Une erreur interne du serveur, Opération de recharge a échouée

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