My App
Demandes de paiement

Obtenir une demande de paiement par ID

Récupère une demande de paiement par son ID. Retourne la même structure que le point de terminaison de création mais inclut le statut actuel. **Authentification :** - Nécessite les en-têtes de clé API `X-API-KEY` et `X-API-KEY-ID` **Contrôle d'accès :** - Ne retourne que les demandes de paiement qui appartiennent à l'entreprise authentifiée - Ne retourne que les demandes de paiement créées via l'API Partenaire

GET
/partner_api/payment_requests/{id}

Récupère une demande de paiement par son ID. Retourne la même structure que le point de terminaison de création mais inclut le statut actuel.

Authentification :

  • Nécessite les en-têtes de clé API X-API-KEY et X-API-KEY-ID

Contrôle d'accès :

  • Ne retourne que les demandes de paiement qui appartiennent à l'entreprise authentifiée
  • Ne retourne que les demandes de paiement créées via l'API Partenaire

Authorization

X-API-KEY<token>

Clé API pour les requêtes de l'API Partenaire

In: header

Path Parameters

id*string

Payment request identifier

Formatuuid

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/partner_api/payment_requests/d22c81f3-ee04-4ec5-8bd2-cd8af5dabcfc"
{
  "id": "d22c81f3-ee04-4ec5-8bd2-cd8af5dabcfc",
  "storeId": "59ae202a-f583-4a15-970f-9e99bd1e0baa",
  "reference": "PAY-2024-001",
  "type": "redirect",
  "paymentMethod": "wave",
  "status": "success",
  "errorReason": "Payment failed",
  "transaction": {
    "id": "txn_1234567890",
    "amount": {
      "amount": 10000,
      "currency": "XOF"
    },
    "fees": {
      "amount": 10000,
      "currency": "XOF"
    },
    "status": "success",
    "counterpartLabel": "Customer Name",
    "counterpartIdentifier": "+2250701234567",
    "description": "Payment for order #12345",
    "executedAt": "2024-01-15 14:30:25"
  }
}
{
  "id": "unauthorized",
  "message": "Unauthorized",
  "extras": "Détails supplémentaires de l'erreur"
}
{
  "id": "payment_request_not_found",
  "message": "Demande de paiement non trouvée",
  "extras": "Demande de paiement non trouvée"
}
{
  "id": "internal_error",
  "message": "Une erreur inattendue s'est produite",
  "extras": "Détails supplémentaires de l'erreur"
}

Créer une demande de paiement POST

Crée une nouvelle demande de paiement pour l'entreprise authentifiée. Prend en charge les types de paiement redirect et soundbox. **Types de paiement :** - **redirect** : Retourne une URL de redirection pour les paiements basés sur le web - **soundbox** : Envoie automatiquement la demande de paiement à l'appareil physique Jekobox et retourne le contenu du code QR. La communication avec le dispositif est entièrement gérée par JEKO.

Créer une clé API pour une entreprise marchande (API Fournisseur de services) POST

Crée une clé API pour une entreprise marchande que le fournisseur de services a intégrée. Cela permet au marchand d'accéder à l'API Partenaire. **Prérequis :** - Le fournisseur de services doit avoir intégré l'entreprise marchande (via `/business_onboarding`) - Le fournisseur de services doit avoir la permission de créer des clés API pour le marchand **Cas d'usage :** - Générer des identifiants API pour les marchands après l'intégration - Permettre aux marchands d'intégrer avec l'API Partenaire de Jeko - Gérer l'accès API pour les entreprises marchandes **Notes importantes :** - L'entreprise authentifiée doit être un fournisseur de services - L'entreprise marchande doit exister et être liée au fournisseur de services - La clé API est retournée une seule fois lors de la création - stockez-la de manière sécurisée - La clé API est associée au membre de fournisseur de services qui l'a créée **Authentification :** Nécessite les en-têtes de clé API. L'entreprise authentifiée doit être un fournisseur de services.