BursaPay Logo
Knowledge Base
Ticket Sign In
Help Center > Developer Platform & Gateway API > Virtual Account Credit Event Handling

Virtual Account Credit Event Handling

Published 2026-08-24 5 min read
Who is this article for?
This guide is for Developers, Engineering Teams, Platform Operators seeking operational guidance on BursaPay workflows.

UI Navigation Path (Step-by-Step)

  1. Receive the dedicated_nuban charge.success event.
  2. Identify the dedicated account number from the payload.
  3. Resolve the corresponding developer virtual account.
  4. Apply the wallet credit and emit the developer-facing virtual_account.credited event.
Verified BursaPay workflow: Explain how dedicated NUBAN credit events reach a developer wallet.

1. Overview & Purpose

Paystack dedicated_nuban charge.success events are routed to the virtual-account service, which identifies the dedicated account and credits the developer wallet.

2. Requirements & Setup

The developer must have an active dedicated virtual account and the webhook integration must be operational.

3. Step-by-Step Workflow

  1. Receive the dedicated_nuban charge.success event.
  2. Identify the dedicated account number from the payload.
  3. Resolve the corresponding developer virtual account.
  4. Apply the wallet credit and emit the developer-facing virtual_account.credited event.

4. Rules & Troubleshooting

Do not treat a generic charge.success event as a virtual-account credit unless the channel and dedicated-account data identify it as such.

5. Verification & Next Steps

Reconcile virtual-account credits against the wallet ledger.

Was this article useful?

Related Articles

Payment and Transfer Webhook State Reconciliation Webhook Security: HTTPS, Secrets and Minimal Payload Exposure
Ask Bursa AI