Statut d'une transaction

Cet endpoint permet de consulter l'état et les détails d'une transaction à partir de sa référence partenaire (partnerReference) ou de sa référence système.

Présentation

L'endpoint Statut d'une transaction permet de vérifier en temps réel si une opération (crédit, débit, réabonnement) a été validée (CONFIRMED), est en attente (PENDING) ou a échoué (FAILED).

URL de Base (selon l'environnement sélectionné) :

  • 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

Vous pouvez basculer d'un environnement à un autre à tout moment depuis le menu déroulant en haut de la console d'essai ci-dessous.

Informations Endpoint

CaractéristiqueDétail
MéthodeGET
URL/external/operation
AuthentificationEn-têtes HTTP X-Auth-ApiKey et X-Auth-ApiSecret

Console d'essai interactive

Tester la recherche de statut de transaction

Interrogez le statut d'une transaction B-MO à l'aide de votre référence unique partenaire.

Authentification (En-têtes B-MO)
Paramètres d'URL / Query Parameters (1)

Paramètres de requête (Query params)

  • partnerReference (obligatoire) : La référence unique transmise par votre application lors de la création de la transaction.

Codes de Statut HTTP

  • 200 OK : La transaction a été trouvée et ses détails sont renvoyés.
  • 404 Not Found : Aucune transaction ne correspond à cette référence.

Exemple de Code (Node.js Axios)

import axios from 'axios';

const apiKey = '+2290196666262';
const apiSecret = 'y7MwWuWeQORtpA==';
const partnerReference = 'REF-TEST-001';

axios.get('https://svc.pap.bestcash.me/external/operation', {
  headers: {
    'X-Auth-ApiKey': apiKey,
    'X-Auth-ApiSecret': apiSecret
  },
  params: {
    partnerReference: partnerReference
  }
})
.then(response => {
  console.log('Détails de la transaction :', response.data);
})
.catch(error => {
  if (error.response?.status === 404) {
    console.error('Erreur : Transaction introuvable.');
  } else {
    console.error('Une erreur est survenue :', error.message);
  }
});