Guides
  1. Quickstart

Quickstart: Accept Payments in 15 Min

Complete the first NadaPay activation path by authenticating, making a test API call, and moving into the current integration guides.

Complete the first NadaPay activation path in 15 minutes by authenticating, making a test API call, and moving into the current integration guides.

⚠️

Checkout, invoice, SDK, and payment-link flows are still in development. This Quickstart keeps the activation path focused on the currently documented HTTP API flow until those products are ready.

Prerequisites

  1. Get your NadaPay API key from your dashboard or onboarding contact.
  2. Confirm the API base URL your team should use.
  3. Store the API key in a server-side secret manager or environment variable.

Step 1 — Set your API key

export NADAPAY_API_KEY="your_api_key"
export NADAPAY_BASE_URL="YOUR_NADAPAY_BASE_URL"

Step 2 — Authenticate with x-api-key

Send the API key in the x-api-key header on every request.

curl --request GET \
  --url "$NADAPAY_BASE_URL/organizations/accounts" \
  --header "x-api-key: $NADAPAY_API_KEY" \
  --header "Accept: application/json"

If this request succeeds, your API key and base URL are configured correctly.

For the full authentication reference, see API Authentication.

Step 3 — Save a source account

Use the account response to save the source account ID your integration will use for funding, quote generation, and transaction execution.

Step 4 — Continue to the implementation guide

After the first authenticated request succeeds, continue with the relevant Integration Guide:

What success looks like

  • your request includes the x-api-key header
  • the accounts request returns successfully
  • you save an account ID for the next implementation step
  • you know which Integration Guide to open next

Do not continue if

  • the API key is missing or invalid
  • the base URL is not configured
  • you cannot retrieve organization accounts

Next steps

⚠️

Checkout, invoice, SDK, and payment-link flows are still in development. This Quickstart keeps the activation path focused on the currently documented HTTP API flow until those products are ready.

Prerequisites

  1. Get your NadaPay API key from your dashboard or onboarding contact.
  2. Confirm the API base URL your team should use.
  3. Store the API key in a server-side secret manager or environment variable.

Step 1 — Set your API key

export NADAPAY_API_KEY="your_api_key"
export NADAPAY_BASE_URL="YOUR_NADAPAY_BASE_URL"

Step 2 — Authenticate with x-api-key

Send the API key in the x-api-key header on every request.

curl --request GET \
  --url "$NADAPAY_BASE_URL/organizations/accounts" \
  --header "x-api-key: $NADAPAY_API_KEY" \
  --header "Accept: application/json"

If this request succeeds, your API key and base URL are configured correctly.

For the full authentication reference, see API Authentication.

Step 3 — Save a source account

Use the account response to save the source account ID your integration will use for funding, quote generation, and transaction execution.

Step 4 — Continue to the implementation guide

After the first authenticated request succeeds, continue with the relevant Integration Guide:

What success looks like

  • your request includes the x-api-key header
  • the accounts request returns successfully
  • you save an account ID for the next implementation step
  • you know which Integration Guide to open next

Do not continue if

  • the API key is missing or invalid
  • the base URL is not configured
  • you cannot retrieve organization accounts

Next steps

Updated about 1 month ago