Skip to main content
Talescria is a payments platform for businesses. With the API you can:

Hold money

Open accounts in USD, GBP, EUR, NGN, KES, ZAR and GHS, and read their balances.

Pay people

Add recipients and pay them by bank transfer or mobile money, in their currency.

Move between accounts

Convert between your own accounts at a quoted rate.

Get paid

Take card payments with payment links, hosted checkout and invoices.

How the API works

  • REST over HTTPS at https://api.talescria.com, with JSON requests and responses.
  • OAuth 2 client credentials. Your server exchanges an OAuth client’s id and secret for a short-lived access token. See Authentication.
  • Test and live. Every key belongs to one environment. Test keys work as soon as you sign up; live keys work once your account is approved. See Environments.
  • Safe retries. Writes that create something or move money take an Idempotency-Key, so a retry never pays twice. See Idempotency.
  • Exact amounts. Amounts are integers in the currency’s smallest unit, sent as strings. See Money.

Start here

1

Make your first request

Follow the quickstart to create an OAuth client, get a token and list your accounts in about five minutes.
2

Try a flow in the sandbox

The sandbox guide lists bank details and test cards that work in test mode.
3

Read the reference

Every operation, field and error is in the API reference.