Approvisionnement de compte

Introduction

L’approvisionnement (provisioning) est un type de transaction qui transfère des fonds du compte de collecte (compte pay-in) vers le compte de transfert (compte pay-out) d’un même marchand.

Une demande d’approvisionnement effectuée avec une clé d’API est soumise à validation et approbation par HUB2. En dessous d’un certain montant, elle peut être approuvée automatiquement. Contactez l’équipe support pour plus d’informations sur les conditions d’approvisionnement.

Un approvisionnement a l’un des statuts suivants : created, pending, successful ou failed.

Créer un approvisionnement

Référence API HUB2 - Créer un approvisionnement

curl --location --request POST 'https://api.hub2.io/provisionings' \
--header 'ApiKey: [REDACTED]' \
--header 'MerchantId: [REDACTED]' \
--header 'Environment: sandbox' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": 200,
    "currency": "XOF",
    "description": "Provisioning test"
}'

const headers = {
    'ApiKey': '[REDACTED]',
    'MerchantId': '[REDACTED]',
    'Environment': 'sandbox',
    'Content-Type': 'application/json'
};

const data = {
    amount: 200,
    currency: "XOF",
    description: "Provisioning test"
};

fetch('https://api.hub2.io/provisionings', {
    method: 'POST',
    headers: headers,
    body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => console.log(data))
.catch((error) => console.error('Error:', error));

import requests

headers = {
    'ApiKey': '[REDACTED]',
    'MerchantId': '[REDACTED]',
    'Environment': 'sandbox',
    'Content-Type': 'application/json',
}

data = {
    "amount": 200,
    "currency": "XOF",
    "description": "Provisioning test",
}

response = requests.post('https://api.hub2.io/provisionings', headers=headers, json=data)

print(response.json())

La réponse est une demande d’approbation (action) créée et en attente d’approbation :

{
    "id": 32,
    "action": "provisioning",
    "status": "created",
    "authorId": "apiKey",
    "merchantId": "[REDACTED]",
    "params": {
        "amount": 200,
        "currency": "XOF",
        "description": "Provisioning test",
        "mode": "sandbox"
    },
    "createdAt": "2023-11-07T11:21:19.561Z",
    "updatedAt": "2023-11-07T11:21:19.561Z"
}

Une fois la demande approuvée, l’approvisionnement correspondant apparaît dans la liste des approvisionnements et dans le dashboard.

Récupérer les approvisionnements

Référence API HUB2 - Lister les approvisionnements

curl --location --request GET 'https://api.hub2.io/provisionings?page=1&perPage=10' \
--header 'ApiKey: [REDACTED]' \
--header 'MerchantId: [REDACTED]' \
--header 'Environment: sandbox' \
--header 'Content-Type: application/json'

import fetch from 'node-fetch';

const url = 'https://api.hub2.io/provisionings?page=1&perPage=10';
const headers = {
    'ApiKey': '[REDACTED]',
    'MerchantId': '[REDACTED]',
    'Environment': 'sandbox',
    'Content-Type': 'application/json'
};

fetch(url, { method: 'GET', headers: headers })
    .then(response => response.json())
    .then(data => console.log(data))
    .catch((error) => console.error('Error:', error));

import requests

url = "https://api.hub2.io/provisionings?page=1&perPage=10"
headers = {
    'ApiKey': '[REDACTED]',
    'MerchantId': '[REDACTED]',
    'Environment': 'sandbox',
    'Content-Type': 'application/json',
}

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

print(response.json())

La réponse est un tableau d’approvisionnements. Utilisez les paramètres de requête page et perPage pour paginer (perPage vaut 10 par défaut).

[
    {
        "id": "prov_xxxxxxxxxxxxxxxxxxxxx",
        "date": "2023-10-17T12:31:27.793Z",
        "withdrawal": {
            "id": "wtd_xxxxxxxxxxxxxxxxxxxxx",
            "type": "withdrawal",
            "date": "2023-10-17T12:31:27.959Z",
            "amount": 100,
            "currency": "XOF"
        },
        "deposit": {
            "id": "dep_xxxxxxxxxxxxxxxxxxxxx",
            "type": "deposit",
            "date": "2023-10-17T12:31:27.959Z",
            "amount": 100,
            "currency": "XOF"
        },
        "description": "Provisioning test",
        "status": "successful"
    },
    {
        "id": "prov_yyyyyyyyyyyyyyyyyyyyy",
        "date": "2023-10-17T12:31:04.405Z",
        "withdrawal": {
            "id": "wtd_yyyyyyyyyyyyyyyyyyyyy",
            "type": "withdrawal",
            "date": "2023-10-17T12:31:04.473Z",
            "amount": 100,
            "currency": "XOF"
        },
        "deposit": {
            "id": "dep_yyyyyyyyyyyyyyyyyyyyy",
            "type": "deposit",
            "date": "2023-10-17T12:31:04.473Z",
            "amount": 100,
            "currency": "XOF"
        },
        "description": "Provisioning test",
        "status": "successful"
    }
]

withdrawal : la transaction débitée du compte de collecte.
deposit : la transaction créditée sur le compte de transfert.

Pour récupérer un seul approvisionnement, utilisez GET /provisionings/{id}.

Guide de démarrage

Transferts

Paiements

Webhooks

Processing Only

Payment Links

Sous-marchands

Autre

Introduction

Créer un approvisionnement

Récupérer les approvisionnements

​Introduction

​Créer un approvisionnement

​Récupérer les approvisionnements

Introduction

Créer un approvisionnement

Récupérer les approvisionnements