1app
Create Business AccountCreate Personal Account
Search…
Introduction
Authentication
Balance
Webhook
BILLS PAYMENT
Send Money
Data Plans
Data Bundle
Airtime
Verify Electricity
Vend Electricity
Cable TV List
Verify IUC
Vend CableTv
Bank List
Verify Account Number
COLLECT PAYMENT
Initialize a Transaction
Verify a Transaction
Transactions List
Transaction Details
Customers
Payouts / Settlements
Settlement Transactions
Fetch Disputes
Accept a Dispute
Decline a Dispute
CUSTOM INTEGRATION
Create Wallet
Contact
Contact Us
Security
Universal Blacklist
Powered By GitBook
Webhook
Webhooks allow you to set up a notification system that can be used to receive updates on certain requests made to the 1app APIs.
You can configure webhook endpoints via the API to be notified about events that happen in your 1app account or connected accounts.
To receive webhook requests, you have to setup your webhook URL on your account dashboard.
Once the webhook registration for an event is completed, you will receive webhook requests at the destination URL you provided each time a transaction occur on your account.
When your webhook URL receives an event, it needs to parse and acknowledge the event. Acknowledging an event means returning a 200 OK in the HTTP header. Without a 200 OK in the response header, we flagged it as a failed attempt, we’ll keep sending events for the next 48 hours at 30 minute interval upon the first failure to acknowledged the even with 200 OK.
Creating a Webhook endpoint can be easily done on your dashboard by following these steps.
  • Log in to the 1app Dashboard and click on Settings page, then the Developers tab.
  • Click on the Developers tab.
  • Fill in the required details for your webhook.
  • Once complete, click the save changes to save the setup.
  • Test your webhook to ensure you’re getting the JSON body and returning a 200 OK HTTP response

Sample Response

{
"event_type": "transactions",
"data": {
"trans_status": "06",
"message": "Successful",
"transmode": "live",
"feeby": "split",
"reference": "1B6579758742351347",
"TransDetails": {
"transref": "1B6579758742351347",
"clientref": "",
"amountpaid": "10000.00",
"amount_settled": "9950.00",
"fee": "50.00",
"currency": "NGN",
"transtoken": "de2ec4d82c7c15da23c39fc6a6f42",
"previous_bal": "100000.00",
"new_bal": "19950.00",
"payment_channel": "",
"payment_time": "Sat, 16 Jul 2022",
"redirect_url": "",
"transmsg": ""
},
"CustomerDetails": {
"customer_name": "John Doe",
"customer_email": "[email protected]",
"customer_phone": "0701234567"
},
"transerror": 0,
"paid_through": "paylink",
"isflagged": "0"
}
}
Previous
Balance
Next - BILLS PAYMENT
Send Money
Last modified 24d ago
Copy link