Make your first API request

This quickstart confirms that your server can authenticate with NorthFond. It does not move funds or create a payment.

Before you begin

You need a NorthFond business account and a sandbox API key with at least one scope. Create the key in the business dashboard. The secret is shown once.

Keep API keys on your server. Never expose them in browser code, mobile applications, screenshots, logs, or source control.

Export your sandbox key

Store the secret in your shell for this session.

export NORTHFOND_API_KEY="nf_test_replace_with_your_key"

Request your account context

curl --request GET \
  --url https://payment.gideondevrel.xyz/api/v1/business/account \
  --header "Authorization: Bearer $NORTHFOND_API_KEY"

Confirm the environment

A successful response identifies the business, environment, credential prefix, and granted scopes.

{
  "id": "8d15d149-51a1-4b0e-a7e0-4a9ec5ea6970",
  "name": "Acme Payments",
  "environment": "sandbox",
  "credential": {
    "id": "7eafef9a-07cf-486a-91f1-c494190e6fd4",
    "prefix": "nf_test_V2nJ64JC",
    "scopes": ["customers:read", "customers:write"]
  }
}

The current public sandbox origin is https://payment.gideondevrel.xyz. NorthFond will publish the production NorthFond-owned API hostname before general availability.

Where to go next

Create a customer

Provision a reusable managed EVM wallet from your own customer reference.

Explore the API

Open the generated endpoint reference, schemas, and request builder.

Common failures

Response	Check
`401`	The key is missing, malformed, expired, or revoked.
`403`	The key lacks permission or your source IP is not allowed.
`429`	Wait for `Retry-After`, then retry with backoff.

⌘I

Overview

Platform

Resources

Operate

Before you begin

Where to go next

Create a customer

Explore the API

Common failures

​Before you begin

​Where to go next

Create a customer

Explore the API

​Common failures

Before you begin

Where to go next

Common failures