1app
Create Boldd AccountLogin
  • Introduction
  • Authentication
  • Balance
  • Get Exchange Rate
  • Response Code
  • RECEIVE PAYMENTS
    • Payments
      • Initialize Payment
      • Verify Payment
      • Payment List
      • Payment Details
    • Inline/Popup Checkout
    • Payouts / Settlements
      • Payouts List
      • Settlement Transactions
    • Dispute Management
      • Fetch Disputes
      • Accept a Dispute
      • Decline a Dispute
    • Customers List
    • Webhook Notifications
    • Repush Notification
  • Virtual Accounts
    • Get Available Banks
    • Setup Preferred Bank
    • Generate Account
    • Virtual Account List
    • Account Transactions
    • Virtual Account Webhook
      • Notifications history
  • MAKE PAYMENTS
    • Airtime Purchase
    • Send Money
      • Verify Account Number
      • Make Transfer
    • Data Purchase
      • Data Plans
      • Data Bundle
    • Electricity
      • Electricity Billers
      • Verify Meter Number
      • Vend Electricity
    • Cable TV
      • Cable TV List
      • Verify IUC
      • Vend CableTv
    • Bank List
    • Payment Status
  • CUSTOMERS
    • Create Customer
  • VIRTUAL CARDS
    • Create Card Account
    • Cards Issuance
    • Card Funding
    • Card Transactions
    • Get all Cards
    • Cards Details
    • Cards Pan
    • Freeze and Unfreeze Card
  • USD Account
    • Create USD Account
  • IDENTITY
    • BVN Check
    • NIN Checks
  • SUB-ACCOUNTS
    • Create a Sub-Account
    • Attach Bank to a Sub-Account
    • Attach Payout Account
    • Get All Sub-Accounts
    • Sub-Accounts History
    • Sub-Accounts Wallet
  • Miscellaneous
    • Create Wallet
    • Universal Blacklist
  • Contact
    • Contact Us
Powered by GitBook
On this page
  • Transaction Type
  • Sample Request

Was this helpful?

  1. Virtual Accounts

Virtual Account 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 set up 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 occurs on your account.

When your webhook URL receives an event, it needs to parse and acknowledge the event. Acknowledging an event means returning an 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 acknowledge the event with 200 OK.

Creating a Webhook endpoint can be easily done on your dashboard by following these steps.

Transaction Type

In order to know the transaction type you are getting notification for, check the paid_through field on the webhook notification response as stated below.

Sample Request

{
    "event_type": "transactions",
    "event_status": "success",
    "AccountNo": "0123456789",
    "paid_through": "dedicatedAccount",
    "trans_status": "01",
    "transmode": "live",
    "Reference": "957421812B73017",
    "SourceName": "Jogh PETER",
    "AmountPaid": "50000",
    "SettledAmount": 4975,
    "Charged": 25,
    "TrackingID": "0150240",
    "TrackingRef": "0150240",
    "AccountRef": "50240",
    "ClientID": "019",
    "transactionType": "Credit",
    "Narration": "FROM UBA Jogh PETER UNOGWU-USSD-NIPTo 1APPDARAD-john U 23470XXXX3031000004240815123139004464292797",
    "CustomerDetails": {
        "AccountName": "",
        "AccountNo": "0123456789",
        "BankName": "Providus Bank",
        "TrackingId": "0150240"
    },
    "SourceDetails": {
        "SourceName": "Jogh PETER",
        "SourceAcct": "0219110003",
        "SourceBank": "UNITED BANK FOR AFRICA",
        "Narration": "FROM UBA Jogh PETER-USSD-NIPTo 1APPDARAD-PETER U 23470XXXX3031000004240815123139004464292797"
    },
    "transerror": "0"
}
PreviousAccount TransactionsNextNotifications history

Last updated 9 months ago

Was this helpful?