Error
A valid request URL is required to generate request examplesTRANSACTION
Réponses Webhook (IPN)
Envoie une notification IPN au partenaire après le traitement d’une transaction.
POST
/
votre_url_webhook
Error
A valid request URL is required to generate request examplesCette page documente les notifications IPN (Instant Payment Notification) que vous recevrez sur votre webhook.
Description:
- Type: Webhook (callback POST)
- Utilisation: KAYBIC AFRICA envoie automatiquement les mises à jour de statut de transaction à l’URL IPN que vous avez configurée.
Exemple de réponse Webhook - SUCCESSFUL
{
"transaction_id": "EFB.144358",
"amount": 1000,
"benefice": 1000,
"commission": 0,
"destination": "0500156008",
"fee": 0,
"response": "operation success",
"error": "",
"service_id": 14,
"customer_name": "KAYBIC AFRICA",
"state": "SUCCESSFUL",
"custom_data": "custom_data",
"ipn_url": "",
"provider_id": null,
"sms_link": 0,
"created_at": "2022-10-18T02:38:44.000+00:00",
"updated_at": "2022-10-18T02:38:44.000+00:00",
"ipn_state": 0,
"w_amount_after_transaction": "",
"p_last_wallet_amount": 11,
"p_new_wallet_amount": null,
"p_id": 1,
"hash": ""
}
Exemple de réponse Webhook - FAILED
{
"transaction_id": "EFB.144359",
"amount": 2000,
"benefice": 2000,
"commission": 0,
"destination": "0670123456",
"fee": 0,
"response": "",
"error": "message de l'erreur",
"service_id": 10,
"customer_name": "KAYBIC AFRICA",
"state": "FAILED",
"custom_data": "transaction_ref_123",
"ipn_url": "",
"provider_id": null,
"sms_link": 0,
"created_at": "2022-10-18T02:38:44.000+00:00",
"updated_at": "2022-10-18T02:38:44.000+00:00",
"ipn_state": 0,
"w_amount_after_transaction": "",
"p_last_wallet_amount": 11,
"p_new_wallet_amount": null,
"p_id": 1,
"hash": ""
}
Champs importants
transaction_id: Identifiant unique de la transactionstate: Statut final de la transaction (SUCCESSFULouFAILED)response: Message de réponse en cas de succèserror: Message d’erreur en cas d’échecamount: Montant de la transactioncustom_data: Données personnalisées que vous avez envoyées lors de l’initiation
Notes
- ⚠️ Important: Vous devez retourner un code HTTP 200 pour confirmer la réception du webhook.
- Si vous ne répondez pas, KAYBIC AFRICA tentera de renvoyer la notification plusieurs fois.
- Les webhooks arrivent généralement dans les secondes suivant le traitement de la transaction.
- Utilisez le champ
custom_datapour réconcilier les transactions avec vos données internes.
Body
application/json
Example:
"EFB.144358"
Example:
1000
Example:
1000
Example:
0
Example:
"0500156008"
Example:
0
Example:
"operation success"
Example:
"message de l'erreur (si transaction Echec)"
Example:
14
Example:
"KAYBIC AFRICA"
Example:
"FAILED"
Example:
"custom_data"
Example:
""
Example:
null
Example:
0
Example:
"2022-10-18T02:38:44.000+00:00"
Example:
"2022-10-18T02:38:44.000+00:00"
Example:
0
Example:
""
Example:
11
Example:
null
Example:
1
Example:
""
⌘I