Lister les transactions du magasin

curl --request GET \
  --url https://api.jeko.africa/partner_api/transactions \
  --header 'X-API-KEY: <api-key>'

{
  "total": 150,
  "perPage": 20,
  "currentPage": 1,
  "data": [
    {
      "id": "txn_1234567890",
      "type": "payment",
      "status": "success",
      "amount": {
        "amount": 10000,
        "currency": "XOF"
      },
      "fees": {
        "amount": 10000,
        "currency": "XOF"
      },
      "currency": "XOF",
      "paymentMethod": "wave",
      "counterpartLabel": "John Doe",
      "counterpartIdentifier": "+2250701234567",
      "description": "Payment for order #12345",
      "reference": "REF-2025-001",
      "createdAt": "2025-01-15T14:30:25.000Z"
    }
  ]
}

Transactions

Lister les transactions du magasin

Retourne une liste paginée de transactions dans une plage de dates. Peut être filtrée par magasin.

Informations sur les transactions :

Inclut les types de transactions : paiements et virements
Les transactions sont ordonnées par date de création (plus récentes en premier)
Chaque transaction inclut le montant, les frais, le statut et les informations de la contrepartie

Plage de dates :

Par défaut : 7 derniers jours si startDate et endDate ne sont pas fournis
Plage de dates maximale : 90 jours
La date de fin doit être postérieure ou égale à la date de début
Format de date : YYYY-MM-DD

Pagination :

Page par défaut : 1
Limite par défaut : 100 transactions par page
Limite maximale par page : 100 transactions
Utilisez le paramètre page pour naviguer dans les résultats

Cas d’usage :

Générer des rapports de transactions pour la comptabilité
Réconcilier les paiements et virements
Afficher l’historique des transactions dans votre application
Exporter les données de transaction pour analyse

Authentification : Nécessite les en-têtes de clé API.

GET

/

partner_api

/

transactions

Lister les transactions du magasin

curl --request GET \
  --url https://api.jeko.africa/partner_api/transactions \
  --header 'X-API-KEY: <api-key>'

{
  "total": 150,
  "perPage": 20,
  "currentPage": 1,
  "data": [
    {
      "id": "txn_1234567890",
      "type": "payment",
      "status": "success",
      "amount": {
        "amount": 10000,
        "currency": "XOF"
      },
      "fees": {
        "amount": 10000,
        "currency": "XOF"
      },
      "currency": "XOF",
      "paymentMethod": "wave",
      "counterpartLabel": "John Doe",
      "counterpartIdentifier": "+2250701234567",
      "description": "Payment for order #12345",
      "reference": "REF-2025-001",
      "createdAt": "2025-01-15T14:30:25.000Z"
    }
  ]
}

Authorizations

X-API-KEY

string

header

required

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

Query Parameters

storeId

string<uuid>

Identifiant du magasin

Example:

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

page

integer

Numéro de page (commence à 1)

Required range: x >= 1

Example:

1

limit

integer

Nombre de transactions par page (max 100)

Required range: 1 <= x <= 100

Example:

20

startDate

string<date>

Date de début pour filtrer les transactions (YYYY-MM-DD). Par défaut, 7 jours en arrière si non fournie.

Example:

"2025-01-01"

endDate

string<date>

Date de fin pour filtrer les transactions (YYYY-MM-DD, max 90 jours depuis startDate). Par défaut, aujourd'hui si non fournie.

Example:

"2025-01-31"

Response

Transactions récupérées avec succès

Paginated list of transactions

total

integer

required

Total number of transactions matching the filter

Example:

150

perPage

integer

required

Number of transactions per page

Example:

20

currentPage

integer

required

Current page number

Example:

1

data

object[]

required

Array of transactions

Show child attributes

Obtenir le solde du magasin

Lister les appareils