Quick Start

This guide takes you from your Sandbox credentials to your first successful API call.

Before you start

Sandbox credentials are issued as part of the CA integration process: you submit a requirements sheet, we run a kickoff meeting, and CA then opens your Sandbox. If you do not have credentials yet, start with the Integration Process — it covers every stage, including the requirements sheet you need to complete first.

Step 1 — Authenticate

Exchange your credentials for a short-lived access token.

curl -X POST https://api.sandbox.capay.com.au/authenticate \
  -H "Content-Type: application/json" \
  -d '{ "apiUser": "your-api-user", "apiKey": "your-api-key" }'

Response:

{
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expiresInSeconds": 3600
}

See Authentication for the full token lifecycle.

Step 2 — Make your first call

Use the token as a Bearer credential. For example, check your balances:

curl "https://api.sandbox.capay.com.au/accounts/balances" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Step 3 — Learn the model

One concept underpins everything: what clientId means for you. Read Understanding Your Account — it explains how a single call applies either to you or to an underlying customer.

Environments

Only the base URL changes when you switch environments:

Environment	Base URL
Sandbox	https://api.sandbox.capay.com.au
Production	https://api.capay.com.au

Going live

Once your internal testing in Sandbox is complete, notify your Integration Support team. CA reviews your integration against the requirements sheet you submitted and, after sign-off, issues your Production credentials to your Company Admin. See the integration process for how the review and the credential handover work.

Where to go next

To…	See
Understand accounts, balances, and the ledger	Accounts, Balances & Transactions
Add someone to pay	Beneficiaries
Send a payment	Payments
Receive funds	Deposits
Get real-time updates	Webhooks

Need help? Your Account Manager and Integration Support team are ready to assist.