Lister vos opérations
curl --request GET \
--url https://guichet.apidjonanko.tech/v1/operations \
--header 'x-api-key: <api-key>' \
--header 'x-api-secret: <api-key>'const options = {
method: 'GET',
headers: {'x-api-key': '<api-key>', 'x-api-secret': '<api-key>'}
};
fetch('https://guichet.apidjonanko.tech/v1/operations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://guichet.apidjonanko.tech/v1/operations"
headers = {
"x-api-key": "<api-key>",
"x-api-secret": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://guichet.apidjonanko.tech/v1/operations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>",
"x-api-secret: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"total": 184,
"limit": 50,
"offset": 0,
"items": [
{
"reference": "GUI-CI-20261001-7K2M9QX4",
"type": "CASHIN",
"status": "CREATED",
"amount": 5000,
"fees": 100,
"netAmount": 4900,
"currency": "XOF",
"country": "CI",
"operator": "ORANGE",
"counterparty": {
"phoneNumber": "+2250701020304",
"name": "Aya Koné"
},
"externalReference": "CMD-2026-00184",
"description": "Commande 184",
"payerActionUrl": "https://pay.example.com/s/abc123",
"requiresPayerAction": true,
"failure": {
"code": "OPERATOR_INSUFFICIENT_FUNDS",
"message": "Le solde du compte mobile money du payeur est insuffisant."
},
"metadata": {},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"completedAt": "2023-11-07T05:31:56Z",
"expiresAt": "2023-11-07T05:31:56Z"
}
]
}{
"success": false,
"error": {
"code": "INVALID_CREDENTIALS",
"message": "Identifiants API invalides."
},
"requestId": "9f1c2b7e-4a5d-4c8f-b0a1-e2d3c4b5a697",
"timestamp": "2026-10-01T10:12:04.000Z"
}Opérations
Lister vos opérations
Encaissements et transferts confondus, les plus récents d’abord.
GET
/
operations
Lister vos opérations
curl --request GET \
--url https://guichet.apidjonanko.tech/v1/operations \
--header 'x-api-key: <api-key>' \
--header 'x-api-secret: <api-key>'const options = {
method: 'GET',
headers: {'x-api-key': '<api-key>', 'x-api-secret': '<api-key>'}
};
fetch('https://guichet.apidjonanko.tech/v1/operations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://guichet.apidjonanko.tech/v1/operations"
headers = {
"x-api-key": "<api-key>",
"x-api-secret": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://guichet.apidjonanko.tech/v1/operations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>",
"x-api-secret: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"total": 184,
"limit": 50,
"offset": 0,
"items": [
{
"reference": "GUI-CI-20261001-7K2M9QX4",
"type": "CASHIN",
"status": "CREATED",
"amount": 5000,
"fees": 100,
"netAmount": 4900,
"currency": "XOF",
"country": "CI",
"operator": "ORANGE",
"counterparty": {
"phoneNumber": "+2250701020304",
"name": "Aya Koné"
},
"externalReference": "CMD-2026-00184",
"description": "Commande 184",
"payerActionUrl": "https://pay.example.com/s/abc123",
"requiresPayerAction": true,
"failure": {
"code": "OPERATOR_INSUFFICIENT_FUNDS",
"message": "Le solde du compte mobile money du payeur est insuffisant."
},
"metadata": {},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"completedAt": "2023-11-07T05:31:56Z",
"expiresAt": "2023-11-07T05:31:56Z"
}
]
}{
"success": false,
"error": {
"code": "INVALID_CREDENTIALS",
"message": "Identifiants API invalides."
},
"requestId": "9f1c2b7e-4a5d-4c8f-b0a1-e2d3c4b5a697",
"timestamp": "2026-10-01T10:12:04.000Z"
}Authorizations
Votre clé publique, préfixée gk_live_ (ou gk_test_).
Votre secret, préfixé gs_live_ (ou gs_test_). Affiché une seule fois, à l'émission de la clé. Il ne doit jamais quitter vos serveurs.
Query Parameters
Available options:
CASHIN, CASHOUT État d'une opération.
CREATED— enregistrée, pas encore soumisePENDING— soumise, en attente d'issueAWAITING_PAYER— encaissement : le payeur doit agirSUCCEEDED— aboutie (définitif)FAILED— refusée (définitif)EXPIRED— aucune issue dans le délai (définitif)CANCELLED— annulée avant exécution (définitif)REVERSED— contre-passée (définitif)
Une opération réussie ne repasse jamais en échec. Le seul mouvement possible
depuis SUCCEEDED est REVERSED.
Available options:
CREATED, PENDING, AWAITING_PAYER, SUCCEEDED, FAILED, EXPIRED, CANCELLED, REVERSED Pays, en ISO 3166-1 alpha-2.
Available options:
CI, BF, ML, SN, TG, BJ, NE, CM, GN Example:
"CI"
Opérateur mobile money. Tous ne sont pas disponibles dans tous les pays — voir le guide « Pays et opérateurs ».
Available options:
ORANGE, MTN, MOOV, WAVE, DJAMO Example:
"ORANGE"
Votre propre référence d'opération.
Maximum string length:
120Borne basse de création, au format ISO 8601.
Borne haute de création, au format ISO 8601.
Nombre maximum d'éléments renvoyés.
Required range:
1 <= x <= 200Nombre d'éléments à ignorer avant de commencer la page.
Required range:
x >= 0