Get Deposit Instructions

Get deposit instructions so your team or clients know exactly how to fund a NadaPay account.

When to use this page

Use this page when you need the exact funding instructions for a NadaPay account before money is sent into the platform.

Prerequisites

1. Set your NadaPay API base URL in $baseUrl.
2. Export your NadaPay API key as YOUR_API_KEY.
3. Generate a unique idempotency key for the request.

Before you continue

• confirm the destination nadapayCode for the account you want to fund
• confirm the source currency, country, and amount for the funding flow
• gather any additional values required inside source.details for the rail you are using

Step 1 — Fetch deposit instructions

curl --request POST \
  --url $baseUrl/transactions/deposit-instructions \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --header 'x-idempotency-key: YOUR_UNIQUE_UUID' \
  --data '{
    "source": {
      "currency": "USD",
      "country": "NG",
      "amount": 100,
      "details": {}
    },
    "destination": {
      "nadapayCode": "WAL-123"
    }
  }'

Response:

A successful response returns the deposit instructions for the requested source and destination. Use the response shape shown in the API Reference for this endpoint.

Response — error:

{
  "statusCode": 500,
  "message": "Internal server error"
}

What success looks like

• you receive a full set of funding instructions
• the returned reference is saved and shared with the funding party
• the destination account details match the account you intend to fund

Do not continue if

• the destination nadapayCode is incorrect
• the returned funding instructions do not match the account you intend to fund
• the required funding details for the selected rail are incomplete

Step 2 — Share the instructions with the funding party

Provide the full instruction set, including the reference, to whoever is initiating the inbound transfer. The reference is how NadaPay matches the inbound payment to your wallet.

⚠️

Deposit instructions are unique per wallet and must include the exact reference provided. Missing or incorrect references will delay crediting.

What this step returns

• funding instructions for the destination account
• the reference to include with the inbound payment

Save the returned instruction set exactly as provided and share the reference with the funding party.

Common reasons this step fails

• the destination nadapayCode is incorrect
• the source funding details are incomplete for the selected rail
• the requested funding configuration is not supported

Call this next

• Fetch Organization Accounts
• Fetch Transaction Limits
• Authenticate with x-api-key