Authentification

Un paiement s’authentifie soit par un code OTP, soit par un lien de redirection.

Lien de redirection

Les fournisseurs suivants permettent d’authentifier un paiement par un lien de redirection :

Wave
Ecobank CI
Orange CI et Orange SN

Pour Orange, le parcours par redirection doit être demandé lors de la tentative de paiement : renseignez mobileMoney.workflow à redirection et fournissez mobileMoney.onCancelRedirectionUrl et mobileMoney.onFinishRedirectionUrl. Si l’une de ces URL manque, la requête est rejetée avec une erreur 400 (invalid_url). L’URL de redirection se trouve dans l’objet nextAction, par exemple :

{
    "nextAction": {
        "type": "redirection",
        "message": "mm_wave_live.redirection",
        "data": {
            "url": "https://pay.wave.com/c/mauvaiseUrlPourDemo",
            "method": "get",
            "headers": {},
            "data": {}
        }
    }
}

Toutes les informations nécessaires à la redirection se trouvent dans le champ nextAction.data.

Important

Dans cet exemple, le client est redirigé par une requête GET vers https://pay.wave.com/c/mauvaiseUrlPourDemo.

HUB2 met à jour le statut de l’objet Payment une fois le paiement traité par l’opérateur.

Authentifier un paiement par OTP

Lorsque nextAction est de type otp, authentifiez le paiement avec le point de terminaison dédié et le code de confirmation (confirmationCode) fourni par le client final. Authentifier un paiement Remarque : cette requête peut aussi être envoyée directement par l’application cliente, avec le jeton JWT (token).

curl --location --request POST 'https://api.hub2.io/payment-intents/pi_tffiDaXyWQu203rIXhujW/authentication' \
--header 'Content-Type: application/json' \
--data-raw '{
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpbnRlbnRJZCI6InBpX3RmZmlEYVh5V1F1MjAzcklYaHVqVyIsIm1lcmNoYW50SWQiOiIzIiwibW9kZSI6InNhbmRib3giLCJpYXQiOjE2NTgxMjYxMjV9.1eB6ifC2ldfRw5UstnVa-bQqIdx9_IGLRdwWyXzZR4o",
    "confirmationCode": "4567"
}'

import fetch from 'node-fetch';

async function postAuthentication() {
    const response = await fetch('https://api.hub2.io/payment-intents/pi_tffiDaXyWQu203rIXhujW/authentication', {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json'
        },
        body: JSON.stringify({
            "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpbnRlbnRJZCI6InBpX3RmZmlEYVh5V1F1MjAzcklYaHVqVyIsIm1lcmNoYW50SWQiOiIzIiwibW9kZSI6InNhbmRib3giLCJpYXQiOjE2NTgxMjYxMjV9.1eB6ifC2ldfRw5UstnVa-bQqIdx9_IGLRdwWyXzZR4o",
            "confirmationCode": "4567"
        })
    });

    if (response.ok) {
        const result = await response.json();
        console.log(result);
    } else {
        console.log(`HTTP Status: ${response.status}`);
    }
}

postAuthentication();

import requests
import json

url = 'https://api.hub2.io/payment-intents/pi_tffiDaXyWQu203rIXhujW/authentication'

headers = {
    'Content-Type': 'application/json',
}

data = {
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpbnRlbnRJZCI6InBpX3RmZmlEYVh5V1F1MjAzcklYaHVqVyIsIm1lcmNoYW50SWQiOiIzIiwibW9kZSI6InNhbmRib3giLCJpYXQiOjE2NTgxMjYxMjV9.1eB6ifC2ldfRw5UstnVa-bQqIdx9_IGLRdwWyXzZR4o",
    "confirmationCode": "4567"
}

response = requests.post(url, headers=headers, data=json.dumps(data))

if response.ok:
    print(response.json())
else:
    print(f'HTTP Status: {response.status_code}')

Orange CI et OTP

Lors d’une tentative de paiement Orange CI avec OTP, Orange applique un délai d’expiration de 10 minutes.

Passé ce délai, le paiement expire, ce qui peut dégrader l’expérience du client. Pour l’éviter, demandez l’OTP au client avant d’effectuer la tentative de paiement. Une fois l’OTP fourni par le client, effectuez la tentative de paiement en incluant directement l’OTP dans le corps de la requête :

curl --location --request POST 'https://api.hub2.io/payment-intents/pi_tffiDaXyWQu203rIXhujW/payments' \
--header 'Content-Type: application/json' \
--data-raw '{
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpbnRlbnRJZCI6InBpX3RmZmlEYVh5V1F1MjAzcklYaHVqVyIsIm1lcmNoYW50SWQiOiIzIiwibW9kZSI6InNhbmRib3giLCJpYXQiOjE2NTgxMjYxMjV9.1eB6ifC2ldfRw5UstnVa-bQqIdx9_IGLRdwWyXzZR4o",
    "paymentMethod": "mobile_money",
    "country": "CI",
    "provider": "orange",
    "mobileMoney": {
        "msisdn": "00000001",
        "otp": "1234"
    }
}'

import fetch from 'node-fetch';

async function postPayments() {
    const response = await fetch('https://api.hub2.io/payment-intents/pi_tffiDaXyWQu203rIXhujW/payments', {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json'
        },
        body: JSON.stringify({
            "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpbnRlbnRJZCI6InBpX3RmZmlEYVh5V1F1MjAzcklYaHVqVyIsIm1lcmNoYW50SWQiOiIzIiwibW9kZSI6InNhbmRib3giLCJpYXQiOjE2NTgxMjYxMjV9.1eB6ifC2ldfRw5UstnVa-bQqIdx9_IGLRdwWyXzZR4o",
            "paymentMethod": "mobile_money",
            "country": "CI",
            "provider": "orange",
            "mobileMoney": {
                "msisdn": "00000001",
                "otp": "1234"
            }
        })
    });

    if (response.ok) {
        const result = await response.json();
        console.log(result);
    } else {
        console.log(`HTTP Status: ${response.status}`);
    }
}

postPayments();

import requests
import json

url = 'https://api.hub2.io/payment-intents/pi_tffiDaXyWQu203rIXhujW/payments'

headers = {
    'Content-Type': 'application/json',
}

data = {
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpbnRlbnRJZCI6InBpX3RmZmlEYVh5V1F1MjAzcklYaHVqVyIsIm1lcmNoYW50SWQiOiIzIiwibW9kZSI6InNhbmRib3giLCJpYXQiOjE2NTgxMjYxMjV9.1eB6ifC2ldfRw5UstnVa-bQqIdx9_IGLRdwWyXzZR4o",
    "paymentMethod": "mobile_money",
    "country": "CI",
    "provider": "orange",
    "mobileMoney": {
        "msisdn": "00000001",
        "otp": "1234"
    }
}

response = requests.post(url, headers=headers, data=json.dumps(data))

if response.ok:
    print(response.json())
else:
    print(f'HTTP Status: {response.status_code}')

HUB2 contactera alors Orange avec toutes les informations et le paiement sera traité immédiatement, sans que l’étape d’authentification ne soit nécessaire.

Guide de démarrage

Transferts

Paiements

Webhooks

Processing Only

Payment Links

Sous-marchands

Autre

Lien de redirection

Important

Authentifier un paiement par OTP

Orange CI et OTP

​Lien de redirection

Important

​Authentifier un paiement par OTP

​Orange CI et OTP

Lien de redirection

Authentifier un paiement par OTP

Orange CI et OTP