Payment API Overview

The Payments API is the pricing and execution engine behind every money movement on NadaPay — payouts, deposits, swaps, and payment link collections all route through it.

Everything needed to send money out to a beneficiary — from registering the destination through executing single or batch payouts.

What's in this section

GuidePurpose
Get Available MarketsCheck which currency corridors are currently active, across all providers
Create a BeneficiaryRegister a payout destination and attach an account
Resolve a Bank AccountVerify the account holder name before adding a bank-based beneficiary
Batch Payout ExecutionExecute multiple payouts from one source in a single request

The payout flow

Get Available Markets   ← confirm the corridor is active
        ↓
Get Supported Networks (Payments API)
        ↓
Resolve a Bank Account   ← required for bank-based rails
        ↓
Create a Beneficiary
        ↓
Add a Beneficiary Account
        ↓
Check Transaction Limits (Payments API)
        ↓
Generate Quote (Payments API)
        ↓
Execute Transaction — or Batch Payout Execution for multiple payouts
        ↓
Webhook confirms final state

Always resolve before adding. Never skip Resolve a Bank Account for bank-based payouts — it's the step that catches misdirected transfers before money moves.



Did this page help you?