Payout API Provider India - NxtBanking

Instant Payout API: Webhooks, Status Codes, and Reconciliation

· Updated · 2 min read

Instant payouts are only as good as your status pipeline. Production teams should design for duplicate callbacks, delayed reversals, and partial batch failures. If you are integrating an instant payout API, treat webhooks as the source of truth after your initiation response.

Idempotency

Always send idempotency keys for payout creation so retries do not double-pay.

Reconciliation

Match bank settlement files with internal ledger daily; APIs reduce but do not eliminate variance investigations.

Related: Best payout API · BBPS API · AEPS API · Mobile recharge API · Request demo

Instant Payout API: Webhooks & Reconciliation Guide

Building a reliable payout system requires more than just initiating bank transfers. You need real-time updates via webhooks and accurate reconciliation to keep your financial records clean. This guide covers both in detail.

What Are Payout Webhooks?

Webhooks are HTTP callbacks that NxtBanking sends to your server whenever a payout transaction changes status. Rather than polling our API every few seconds, your system simply listens for webhook events — making your integration efficient and real-time.

Common Payout Webhook Events

  • payout.initiated — Transaction submitted to banking network
  • payout.processing — Transaction being processed by the bank
  • payout.success — Money credited to beneficiary account
  • payout.failed — Transaction failed (includes error code and reason)
  • payout.reversed — Funds returned to sender wallet

How to Handle Webhooks Securely

  • Verify signature: NxtBanking signs every webhook with HMAC-SHA256. Always verify the signature before processing.
  • Idempotency: Use the reference ID to avoid processing the same event twice.
  • Return 200 quickly: Acknowledge within 5 seconds and process asynchronously.
  • Retry handling: If your server returns non-200, NxtBanking retries 3 times with exponential backoff.

Payout Reconciliation — Daily Process

Reconciliation ensures that your internal records match NxtBanking’s transaction records and your bank statement. Here’s the recommended daily reconciliation flow:

  • Step 1: Download daily transaction report from NxtBanking dashboard (CSV or API)
  • Step 2: Match each transaction against your internal database using the reference ID
  • Step 3: Flag any discrepancies (pending, failed, or reversed transactions)
  • Step 4: Reconcile closing wallet balance against NxtBanking ledger
  • Step 5: Raise disputes for unresolved mismatches within 24 hours

Reconciliation API Endpoints

NxtBanking provides dedicated reconciliation API endpoints:

  • GET /transactions?date=YYYY-MM-DD — Full transaction list for a date
  • GET /transaction/{ref_id}/status — Status of a specific transaction
  • GET /wallet/balance — Real-time wallet balance
  • GET /settlements — Settlement history and amounts

Know More