Live rates(1 USDC → fiat)
Loading…
For banks, fintechs & PSPs

Get started with the NedaPay integration

NedaPay is a B2B2C payment infrastructure layer. Banks, fintechs, and payment service providers use our APIs to initiate cross-border payouts, while NedaPay manages orchestration, digital-asset token settlement, and downstream fiat delivery.

Skip to authenticated API docs
Omni-channel payment layer
Pay anywhere, settle everywhere

Integration at a glance

Who NedaPay is for

Start with the track that matches your role. The underlying APIs are the same; what changes is how you expose them to your customers and how revenue is shared.

Senders

Banks & Financial Institutions

Offer cross-border payouts to your customers without building settlement rails from scratch. NedaPay acts as the orchestration and settlement layer behind your existing channels.

  • Initiate cross-border payouts via a simple REST API
  • Keep full control of pricing and markup
  • White-label experience for web and mobile channels
B2B2C

Fintechs & Platforms

Embed cross-border settlement flows into your product. Use NedaPay as the payment fabric while you own the end-customer relationship.

  • Server-side APIs for initiating and tracking payment orders
  • Webhook-first design for status and reconciliation
  • Multi-tenant friendly for marketplaces and platforms
Providers

PSPs & Liquidity Providers

Plug your payout infrastructure into NedaPay to receive order flow from banks and platforms.

  • Expose your fiat corridors and limits via a single integration
  • Receive assigned orders with full metadata
  • Track commissions and settlement performance

Step-by-step integration

Choose the track that matches your role. Each guide walks through authentication, creating a payment order, handling webhooks, and reconciling payouts across digital-asset tokens and fiat rails.

Banks & Financial Institutions – server-side flow

  1. Create an API key in Settings → API Keys (test first, then live).
  2. Call the Payment Orders API from your core banking backend or integration layer.
  3. Fund the route using your chosen settlement method (digital-asset tokens or fiat).
  4. Listen to webhooks to update customer-facing channels and back-office systems.

Example: initiate a cross-border payout from your bank backend.

POST /api/v1/payment-orders
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "sourceCurrency": "TZS",
  "destinationCurrency": "KES",
  "amount": 100000,
  "settlementRail": "digital_asset_token", // tokens for digital assets
  "recipient": {
    "name": "Jane Doe",
    "bankAccount": "0123456789",
    "bankCode": "ABCDKENX"
  },
  "reference": "INVOICE-2025-001",
  "webhookUrl": "https://yourbank.com/nedapay/webhook"
}

NedaPay will route this order over the optimal rail – digital-asset token off-ramp to fiat, or fiat corridors via partners covering 130+ countries – and push state changes to your webhook URL.

Common lifecycle & webhook example

Regardless of the track, every integration follows the same pattern: create an order, fund or fulfill it, receive status updates, and reconcile.

// Example webhook payload (order.completed)
{
  "type": "order.completed",
  "data": {
    "id": "po_123",
    "reference": "INVOICE-2025-001",
    "sourceCurrency": "TZS",
    "destinationCurrency": "KES",
    "amount": 100000,
    "settlementRail": "digital_asset_token",
    "status": "completed",
    "completedAt": "2025-01-01T10:23:45Z"
  }
}

// Your webhook handler should:
// 1. Verify signature (if configured)
// 2. Match reference/id to your internal records
// 3. Mark payout as settled in your system
// 4. Emit events or update customer-facing UIs

Supported countries & chains

This list is loaded live from NedaPay APIs. Do not hardcode supported coverage.

View full API docs

Supported payout currencies

Lists the fiat currencies/countries you can pay out to.

GET /api/v1/currencies

Loading…

Supported blockchain networks

Lists enabled settlement networks for token settlement.

GET /api/networks

Loading…

Ready for full API details?

Log in to access the authenticated documentation, API reference, and live API playground. There you can generate API keys, test requests, and inspect responses in real time.

Sign in to dashboardOpen authenticated docs