Transférer vers un compte mobile money
curl --request POST \
--url https://guichet.apidjonanko.tech/v1/cashout \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'x-api-key: <api-key>' \
--header 'x-api-secret: <api-key>' \
--data '
{
"amount": 25000,
"country": "CI",
"operator": "WAVE",
"beneficiaryPhone": "0501020304",
"beneficiaryName": "Koffi Yao"
}
'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
'x-api-key': '<api-key>',
'x-api-secret': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
amount: 25000,
country: 'CI',
operator: 'WAVE',
beneficiaryPhone: '0501020304',
beneficiaryName: 'Koffi Yao'
})
};
fetch('https://guichet.apidjonanko.tech/v1/cashout', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://guichet.apidjonanko.tech/v1/cashout"
payload = {
"amount": 25000,
"country": "CI",
"operator": "WAVE",
"beneficiaryPhone": "0501020304",
"beneficiaryName": "Koffi Yao"
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"x-api-key": "<api-key>",
"x-api-secret": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://guichet.apidjonanko.tech/v1/cashout",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'amount' => 25000,
'country' => 'CI',
'operator' => 'WAVE',
'beneficiaryPhone' => '0501020304',
'beneficiaryName' => 'Koffi Yao'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>",
"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;
}{
"operation": {
"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"
}
}{
"operation": {
"reference": "GUI-CO-20261001-4F7K2M9Q",
"type": "CASHOUT",
"status": "PENDING",
"amount": 25000,
"fees": 500,
"netAmount": 25500,
"currency": "XOF",
"country": "CI",
"operator": "WAVE",
"counterparty": {
"phoneNumber": "+2250501020304",
"name": "Koffi Yao"
},
"externalReference": "PAIE-2026-03-0042",
"description": "Salaire mars 2026",
"payerActionUrl": null,
"requiresPayerAction": false,
"failure": null,
"metadata": null,
"createdAt": "2026-10-01T11:01:50.000Z",
"updatedAt": "2026-10-01T11:01:52.000Z",
"completedAt": null,
"expiresAt": "2026-10-01T17:01:50.000Z"
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "La requête est invalide.",
"details": {
"fields": [
"amount must be an integer number"
]
}
},
"requestId": "9f1c2b7e-4a5d-4c8f-b0a1-e2d3c4b5a697",
"timestamp": "2026-10-01T10:12:04.000Z"
}{
"success": false,
"error": {
"code": "INVALID_CREDENTIALS",
"message": "Identifiants API invalides."
},
"requestId": "9f1c2b7e-4a5d-4c8f-b0a1-e2d3c4b5a697",
"timestamp": "2026-10-01T10:12:04.000Z"
}{
"success": false,
"error": {
"code": "INSUFFICIENT_BALANCE",
"message": "Le solde disponible de votre portefeuille est insuffisant.",
"details": {
"available": 12000,
"required": 25500,
"currency": "XOF"
}
},
"requestId": "9f1c2b7e-4a5d-4c8f-b0a1-e2d3c4b5a697",
"timestamp": "2026-10-01T10:12:04.000Z"
}{
"success": false,
"error": {
"code": "INSUFFICIENT_BALANCE",
"message": "Le solde disponible de votre portefeuille est insuffisant.",
"details": {}
},
"requestId": "9f1c2b7e-4a5d-4c8f-b0a1-e2d3c4b5a697",
"timestamp": "2023-11-07T05:31:56Z"
}{
"success": false,
"error": {
"code": "INSUFFICIENT_BALANCE",
"message": "Le solde disponible de votre portefeuille est insuffisant.",
"details": {}
},
"requestId": "9f1c2b7e-4a5d-4c8f-b0a1-e2d3c4b5a697",
"timestamp": "2023-11-07T05:31:56Z"
}{
"success": false,
"error": {
"code": "INSUFFICIENT_BALANCE",
"message": "Le solde disponible de votre portefeuille est insuffisant.",
"details": {}
},
"requestId": "9f1c2b7e-4a5d-4c8f-b0a1-e2d3c4b5a697",
"timestamp": "2023-11-07T05:31:56Z"
}{
"success": false,
"error": {
"code": "INSUFFICIENT_BALANCE",
"message": "Le solde disponible de votre portefeuille est insuffisant.",
"details": {}
},
"requestId": "9f1c2b7e-4a5d-4c8f-b0a1-e2d3c4b5a697",
"timestamp": "2023-11-07T05:31:56Z"
}{
"success": false,
"error": {
"code": "INSUFFICIENT_BALANCE",
"message": "Le solde disponible de votre portefeuille est insuffisant.",
"details": {}
},
"requestId": "9f1c2b7e-4a5d-4c8f-b0a1-e2d3c4b5a697",
"timestamp": "2023-11-07T05:31:56Z"
}Transfert
Transférer vers un compte mobile money
Verse le montant au bénéficiaire et prélève votre portefeuille du montant plus la commission.
Immobilisation
Dès l’acceptation, le montant et la commission sont immobilisés : ils quittent votre solde disponible sans encore être débités.
- transfert exécuté → ils sont débités,
balancediminue ; - transfert échoué → l’immobilisation est levée, votre solde retrouve son niveau.
C’est ce mécanisme qui vous empêche d’engager deux fois le même solde pendant qu’un transfert est en cours.
L’issue définitive arrive par notification (cashout.succeeded /
cashout.failed). Un transfert sans issue au bout de 6 heures passe en
EXPIRED et l’immobilisation est levée.
Cet endpoint exige une clé de production (gk_live_). Une clé de test est
refusée.
POST
/
cashout
Transférer vers un compte mobile money
curl --request POST \
--url https://guichet.apidjonanko.tech/v1/cashout \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'x-api-key: <api-key>' \
--header 'x-api-secret: <api-key>' \
--data '
{
"amount": 25000,
"country": "CI",
"operator": "WAVE",
"beneficiaryPhone": "0501020304",
"beneficiaryName": "Koffi Yao"
}
'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
'x-api-key': '<api-key>',
'x-api-secret': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
amount: 25000,
country: 'CI',
operator: 'WAVE',
beneficiaryPhone: '0501020304',
beneficiaryName: 'Koffi Yao'
})
};
fetch('https://guichet.apidjonanko.tech/v1/cashout', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://guichet.apidjonanko.tech/v1/cashout"
payload = {
"amount": 25000,
"country": "CI",
"operator": "WAVE",
"beneficiaryPhone": "0501020304",
"beneficiaryName": "Koffi Yao"
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"x-api-key": "<api-key>",
"x-api-secret": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://guichet.apidjonanko.tech/v1/cashout",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'amount' => 25000,
'country' => 'CI',
'operator' => 'WAVE',
'beneficiaryPhone' => '0501020304',
'beneficiaryName' => 'Koffi Yao'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>",
"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;
}{
"operation": {
"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"
}
}{
"operation": {
"reference": "GUI-CO-20261001-4F7K2M9Q",
"type": "CASHOUT",
"status": "PENDING",
"amount": 25000,
"fees": 500,
"netAmount": 25500,
"currency": "XOF",
"country": "CI",
"operator": "WAVE",
"counterparty": {
"phoneNumber": "+2250501020304",
"name": "Koffi Yao"
},
"externalReference": "PAIE-2026-03-0042",
"description": "Salaire mars 2026",
"payerActionUrl": null,
"requiresPayerAction": false,
"failure": null,
"metadata": null,
"createdAt": "2026-10-01T11:01:50.000Z",
"updatedAt": "2026-10-01T11:01:52.000Z",
"completedAt": null,
"expiresAt": "2026-10-01T17:01:50.000Z"
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "La requête est invalide.",
"details": {
"fields": [
"amount must be an integer number"
]
}
},
"requestId": "9f1c2b7e-4a5d-4c8f-b0a1-e2d3c4b5a697",
"timestamp": "2026-10-01T10:12:04.000Z"
}{
"success": false,
"error": {
"code": "INVALID_CREDENTIALS",
"message": "Identifiants API invalides."
},
"requestId": "9f1c2b7e-4a5d-4c8f-b0a1-e2d3c4b5a697",
"timestamp": "2026-10-01T10:12:04.000Z"
}{
"success": false,
"error": {
"code": "INSUFFICIENT_BALANCE",
"message": "Le solde disponible de votre portefeuille est insuffisant.",
"details": {
"available": 12000,
"required": 25500,
"currency": "XOF"
}
},
"requestId": "9f1c2b7e-4a5d-4c8f-b0a1-e2d3c4b5a697",
"timestamp": "2026-10-01T10:12:04.000Z"
}{
"success": false,
"error": {
"code": "INSUFFICIENT_BALANCE",
"message": "Le solde disponible de votre portefeuille est insuffisant.",
"details": {}
},
"requestId": "9f1c2b7e-4a5d-4c8f-b0a1-e2d3c4b5a697",
"timestamp": "2023-11-07T05:31:56Z"
}{
"success": false,
"error": {
"code": "INSUFFICIENT_BALANCE",
"message": "Le solde disponible de votre portefeuille est insuffisant.",
"details": {}
},
"requestId": "9f1c2b7e-4a5d-4c8f-b0a1-e2d3c4b5a697",
"timestamp": "2023-11-07T05:31:56Z"
}{
"success": false,
"error": {
"code": "INSUFFICIENT_BALANCE",
"message": "Le solde disponible de votre portefeuille est insuffisant.",
"details": {}
},
"requestId": "9f1c2b7e-4a5d-4c8f-b0a1-e2d3c4b5a697",
"timestamp": "2023-11-07T05:31:56Z"
}{
"success": false,
"error": {
"code": "INSUFFICIENT_BALANCE",
"message": "Le solde disponible de votre portefeuille est insuffisant.",
"details": {}
},
"requestId": "9f1c2b7e-4a5d-4c8f-b0a1-e2d3c4b5a697",
"timestamp": "2023-11-07T05:31:56Z"
}{
"success": false,
"error": {
"code": "INSUFFICIENT_BALANCE",
"message": "Le solde disponible de votre portefeuille est insuffisant.",
"details": {}
},
"requestId": "9f1c2b7e-4a5d-4c8f-b0a1-e2d3c4b5a697",
"timestamp": "2023-11-07T05:31:56Z"
}Le montant et la commission sont immobilisés dès l’acceptation : ils quittent
available sans encore être débités de balance. À l’exécution ils sont débités ; en cas d’échec l’immobilisation est levée. Détail des mouvements : Portefeuille.Cet endpoint exige une clé de production (gk_live_) et l’en-tête Idempotency-Key.Authorizations
Headers
Body
application/json
