Skip to main content

​
Transfers Overview

Use Zentra transfers to create bank payouts, retrieve transfer history, inspect payout fees, and follow transfer lifecycle state safely.

​
Overview

This namespace is part of the reviewed public gateway surface.

​
Reviewed Public Transfer Endpoints

  • POST /api/v1/transfers
  • GET /api/v1/transfers
  • GET /api/v1/transfers/{id}
  • POST /api/v1/transfers/{reference}/verify
  • POST /api/v1/transfers/{reference}/retry
  • GET /api/v1/transfers/stats
  • GET /api/v1/transfers/fees
  • GET /api/v1/banks

​
What Transfers Covers

  • tenant-scoped payout initiation
  • payout history and lookup
  • fee and stats inspection
  • bank directory lookup
  • webhook-driven lifecycle monitoring

​
Integration Notes

  • Amounts should be sent in minor units only.
  • Use a stable reference for replay safety and reconciliation.
  • Retrieval on the reviewed public gateway is by transfer id, while verify and retry operations are keyed by reference.
  • Prefer webhooks for lifecycle updates instead of polling individual transfers aggressively.

​
Compatibility Notes

  • The reviewed public gateway does not currently include a reviewed bulk transfer or standalone resolve account route.
  • Older SDK examples or tenant-specific integrations may still refer to /transfers/bulk or /transfers/resolve-account. Treat those as compatibility or separately issued surfaces unless your approved contract explicitly includes them.

Create Transfer

Initiate a bank transfer

List Transfers

Query transfer history

Get Transfer

Retrieve one transfer by id

Banks

Retrieve supported bank codes