Vérification client

Présentation

L'endpoint Vérification client est une étape préalable essentielle lors des parcours de paiement ou de transfert. Il permet d'interroger le système B-MO pour savoir si l'utilisateur possède déjà un compte et de récupérer son identité.

Cette vérification détermine la conduite à tenir pour la suite des opérations : Crédit (dépôt) ou Débit (retrait/encaissement).

URL de Base selon l'environnement :

• PAP (Pré-production / Défaut) : https://svc.pap.bestcash.me/external
• TEST (Sandbox) : https://svc.test.bestcash.me/external
• LIVE (Production) : https://svc.bmo.bestcash.me/external

Informations Endpoint

Paramètre de chemin (Path Param)

• fullPhoneNumber (obligatoire) : Numéro de téléphone au format international (ex: +2290160000000).

Règles d'Intégration & Logique Métier

1. Si le client existe (HTTP 200 OK)

L'API renvoie l'objet d'identité du client. Vous pouvez enchaîner directement vers des opérations de Crédit ou de Débit.

2. Si le client n'existe pas encore (HTTP 404 Not Found)

Le client n'a pas encore de compte B-MO. Deux cas se présentent :

Pour une opération de Crédit (Transfert vers le client) : Vous pouvez tout de même poursuivre l'opération de transfert. Toutefois, vous devez impérativement fournir les champs firstname et lastname lors de l'appel ultérieur de crédit (/operations/credit). Cela permettra au système de créer automatiquement le compte du client au moment de l'injection des fonds.

Pour une opération de Débit (Prélèvement sur le client) : Ne pas poursuivre. Toute tentative de débit sur un client inexistant échouera, faute de compte à débiter.

Console d'essai interactive

Codes de Statut HTTP

Exemple de Code (Node.js Axios)

import axios from 'axios';

const apiKey = '+2290196666262';
const apiSecret = 'y7MwWuWeQORtpA==';
const phoneNumber = '+2290160000000';

axios.get(`https://svc.pap.bestcash.me/external/customer/${phoneNumber}`, {
  headers: {
    'X-Auth-ApiKey': apiKey,
    'X-Auth-ApiSecret': apiSecret
  },
})
.then(response => {
  console.log('Détails du client :', response.data);
})
.catch(error => {
  if (error.response?.status === 404) {
    console.warn('Client inexistant. Remarque: Si crédit, fournir firstname et lastname.');
  } else {
    console.error('Erreur :', error.message);
  }
});