Introduction

Ces points de terminaison publics sont disponibles pour tous les marchands et ne nécessitent pas de clé API. Ils permettent de consulter les pays, les opérateurs et les codes bancaires pris en charge par HUB2.

Liste des pays

curl --location --request GET 'https://api.hub2.io/data/countries' \
  --header 'Environment: sandbox' \
  --header 'Content-Type: application/json'

const url = 'https://api.hub2.io/data/countries';
const headers = {
  'Environment': 'sandbox',
  'Content-Type': 'application/json'
};

fetch(url, {
  method: 'GET',
  headers: headers
})
  .then(response => {
    if (!response.ok) {
      throw new Error('Network response was not ok');
    }
    return response.json();
  })
  .then(data => {
    console.log(data);
  })
  .catch(error => {
    console.error('There was a problem with your fetch operation:', error);
  });

import requests

url = 'https://api.hub2.io/data/countries'
headers = {
    'Environment': 'sandbox',
    'Content-Type': 'application/json'
}

response = requests.get(url, headers=headers)

if response.status_code == 200:
    print(response.json())
else:
    print('Error:', response.status_code)

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;

public class Main {
    public static void main(String[] args) {
        try {
            URL url = new URL("https://api.hub2.io/data/countries");
            HttpURLConnection connection = (HttpURLConnection) url.openConnection();
            connection.setRequestMethod("GET");
            connection.setRequestProperty("Environment", "sandbox");
            connection.setRequestProperty("Content-Type", "application/json");

            int responseCode = connection.getResponseCode();
            if (responseCode == HttpURLConnection.HTTP_OK) {
                BufferedReader in = new BufferedReader(new InputStreamReader(connection.getInputStream()));
                String inputLine;
                StringBuffer response = new StringBuffer();

                while ((inputLine = in.readLine()) != null) {
                    response.append(inputLine);
                }
                in.close();

                System.out.println(response.toString());
            } else {
                System.out.println("Error: " + responseCode);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

Vous pouvez filtrer les pays par moyen de paiement avec le paramètre de requête facultatif method (par exemple ?method=mobile_money).

Consultez la référence de l’API pour tous les détails.

Utilisez le code pays (BF, SN, etc.) dans les champs pays des paiements et des transferts.

Liste des opérateurs

curl --location --request GET 'https://api.hub2.io/data/providers' \
  --header 'Environment: sandbox' \
  --header 'Content-Type: application/json'

const url = 'https://api.hub2.io/data/providers';
const headers = {
  'Environment': 'sandbox',
  'Content-Type': 'application/json'
};

fetch(url, {
  method: 'GET',
  headers: headers
})
  .then(response => {
    if (!response.ok) {
      throw new Error('Network response was not ok');
    }
    return response.json();
  })
  .then(data => {
    console.log(data);
  })
  .catch(error => {
    console.error('There was a problem with your fetch operation:', error);
  });

import requests

url = 'https://api.hub2.io/data/providers'
headers = {
    'Environment': 'sandbox',
    'Content-Type': 'application/json'
}

response = requests.get(url, headers=headers)

if response.status_code == 200:
    print(response.json())
else:
    print('Error:', response.status_code)

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;

public class Main {
    public static void main(String[] args) {
        try {
            URL url = new URL("https://api.hub2.io/data/providers");
            HttpURLConnection connection = (HttpURLConnection) url.openConnection();
            connection.setRequestMethod("GET");
            connection.setRequestProperty("Environment", "sandbox");
            connection.setRequestProperty("Content-Type", "application/json");

            int responseCode = connection.getResponseCode();
            if (responseCode == HttpURLConnection.HTTP_OK) {
                BufferedReader in = new BufferedReader(new InputStreamReader(connection.getInputStream()));
                String inputLine;
                StringBuffer response = new StringBuffer();

                while ((inputLine = in.readLine()) != null) {
                    response.append(inputLine);
                }
                in.close();

                System.out.println(response.toString());
            } else {
                System.out.println("Error: " + responseCode);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

Vous pouvez filtrer les opérateurs avec les paramètres de requête facultatifs country, method et names (par exemple ?country=CI&method=mobile_money). Seuls les opérateurs activés sont retournés. Passez names sous forme de liste : ?names[]=mtn ou ?names=mtn&names=orange.

Consultez la référence de l’API pour tous les détails.

Utilisez le nom de l’opérateur dans les champs opérateur des paiements et des transferts. Ce champ est insensible à la casse.

Liste des codes bancaires

Les codes bancaires disponibles pour les virements bancaires, regroupés par pays, sont renvoyés par le point de terminaison des codes bancaires.

Couverture des paiements sortants

Les opérateurs, les pays et les types de destination disponibles pour les paiements sortants évoluent dans le temps. GET /data/providers fait foi : interrogez-le pour connaître ce que vous pouvez utiliser à un instant donné, plutôt que de vous appuyer sur une liste figée. Les virements bancaires sortants sont disponibles au Burkina Faso (BF), au Bénin (BJ), en Guinée-Bissau (GW), au Mali (ML), au Niger (NE), au Sénégal (SN) et au Togo (TG). HUB2 valide le compte de destination avant d’envoyer un virement bancaire : un numéro de compte qui ne correspond pas au pays de destination, ou dont la structure est invalide, fait échouer le transfert avec le motif d’échec invalid_destination, et aucune demande n’est envoyée à la banque.

Guide de démarrage

Transferts

Paiements

Paiement instantané

Webhooks

Processing Only

Payment Links

Abonnements

Sous-marchands

Autres produits

Données publiques

Introduction

Liste des pays

Liste des opérateurs

Liste des codes bancaires

Couverture des paiements sortants