Webhook

Integrating webhook to your application is pretty straight forward. Eyowo post data for every transaction back to your servers using your callback URL. You can read up more on webhooks here.

Add Callback URL to App

PUT https://api.console.eyowo.com/v1/apps/settings

Request Body: { "callbackURL": "https://<web_server>/webhook"}

Request Body

Name	Type	Description
callbackURL	string	Web URL

200

{
    “success”: true,
    “message”: “App settings update successful.”
}

You’ll want to ensure that the callback URL accepts a POST request and respond with a status of 200 for the health check process to be successful.

Webhook Payload: BANK TRANSFER

{
  payload: {
    message: 'SUCCESS',
    data: {
      accountName: 'LATEEF JAMES',
      accountNumber: '2000000000',
      amount: 4000,
      transactionReference: '5f3fcb8087......',
      statusCode: '000002'
    },
    type: 'BANK_TRANSFER'
  }
}

See requery bank transfers for statusCode

Webhook Payload: PHONE_TRANSFERS

{
 "payload": {
   "message": "SUCCESS",
   "data": {
     "appWalletMobile": "2347000000",
     "amount": 2500,
     "recipientMobile": "23480000000",
     "transactionReference": "5f3b95......"
   },
   "type": "PHONE_TRANSFER"
 }
}