Skip to main content
You’ll need a Talescria account. Test mode works straight after sign-up, before your business is verified.
1

Create an OAuth client

In the dashboard, go to Settings → OAuth clients → Create, choose Test, and pick the permissions (scopes) it needs. For this quickstart, Accounts: read is enough.Copy the client ID (cl_…) and secret (sk_test_…). The secret is shown once. Store it like a password, on your server only.
2

Get an access token

Exchange the client’s credentials for an access token. Tokens last 15 minutes.
Response
3

List your accounts

Send the token as a bearer token.
A new account has no accounts yet, so you’ll see "accounts": []. That’s expected.
4

Open an account

Opening an account needs the Accounts: write scope. Add it to your client in the dashboard, then get a new token.
The new account has a zero balance. List your accounts again and it’s there.

Next steps

Authentication

Scopes, token lifetimes and refreshing.

Pay a recipient

Add a recipient and send them money.