Skip to main content
GET
/
partner_api
/
payment_requests
/
{id}
Obtenir une demande de paiement par ID
curl --request GET \
  --url https://api.jeko.africa/partner_api/payment_requests/{id} \
  --header 'X-API-KEY: <api-key>'
{
  "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"
  }
}

Authorizations

​
X-API-KEY
string
header
required

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

Path Parameters

​
id
string<uuid>
required

Payment request identifier

Example:

"d22c81f3-ee04-4ec5-8bd2-cd8af5dabcfc"

Response

Demande de paiement récupérée avec succès

Schéma de réponse pour récupérer une demande de paiement par ID

​
id
string
required

Payment request identifier

Example:

"d22c81f3-ee04-4ec5-8bd2-cd8af5dabcfc"

​
storeId
string
required

Identifiant du magasin

Example:

"59ae202a-f583-4a15-970f-9e99bd1e0baa"

​
reference
string
required

Référence de paiement fournie dans la requête originale

Example:

"PAY-2024-001"

​
type
enum<string>
required

Payment type

Available options:
redirect,
soundbox
Example:

"redirect"

​
paymentMethod
enum<string>
required

Payment method used

Available options:
orange,
wave,
mtn,
moov,
djamo
Example:

"wave"

​
status
enum<string>
required

Statut actuel de la demande de paiement

Available options:
pending,
error,
success
Example:

"success"

​
errorReason
string | null

Raison de l'erreur

Example:

"Payment failed"

​
transaction
object

Détails de transaction lorsque le paiement est terminé