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