# Talescria - [Talescria developer docs](https://docs.talescria.com/index.md): Hold money in several currencies, pay people around the world, and get paid by card, all through one API. - [Quickstart](https://docs.talescria.com/quickstart.md): Create an OAuth client, get an access token and list your accounts. - [Testing in the sandbox](https://docs.talescria.com/sandbox.md): Bank details and cards that work in test mode. - [Authentication](https://docs.talescria.com/concepts/authentication.md): OAuth clients, access tokens and scopes. - [Environments](https://docs.talescria.com/concepts/environments.md): Test and live, and how a key decides which one you're in. - [Idempotency](https://docs.talescria.com/concepts/idempotency.md): Retry any write safely with an Idempotency-Key. - [Money](https://docs.talescria.com/concepts/money.md): Amounts, currencies and timestamps. - [Errors and limits](https://docs.talescria.com/concepts/errors.md): Error format, codes, request IDs and rate limits. - [Accounts and balances](https://docs.talescria.com/guides/accounts.md): Open accounts, read balances and receive money by bank transfer. - [Recipients](https://docs.talescria.com/guides/recipients.md): Add the people and businesses you pay, and where to pay them. - [Sending payments](https://docs.talescria.com/guides/payments.md): Pay a recipient, in their currency or yours, and track the outcome. - [Transfers between your accounts](https://docs.talescria.com/guides/transfers.md): Move money between your own accounts, including across currencies. - [Payment links](https://docs.talescria.com/guides/payment-links.md): Share a link anyone can open to pay you by card. - [Hosted checkout](https://docs.talescria.com/guides/checkout.md): Take a card payment for an amount your server decides. - [Customers](https://docs.talescria.com/guides/customers.md): Keep a list of the people and businesses who pay you. - [Invoices](https://docs.talescria.com/guides/invoices.md): Issue invoices your customers pay by card, once or on a schedule. - [API reference](https://docs.talescria.com/api-reference/introduction.md): Base URLs, authentication and conventions. - [Get an access token](https://docs.talescria.com/api-reference/get-an-access-token.md): Exchange an OAuth client's credentials for an access token. - [List accounts](https://docs.talescria.com/api-reference/accounts/list-accounts.md): Every account you hold in the key's environment, with its balances. Rows are sorted by currency. - [Open an account](https://docs.talescria.com/api-reference/accounts/open-an-account.md): Opens a new account in a currency. Its balance starts at zero. - [List recipients](https://docs.talescria.com/api-reference/recipients/list-recipients.md): Your recipients, oldest first. - [Create a recipient](https://docs.talescria.com/api-reference/recipients/create-a-recipient.md): Adds someone you pay. A recipient is who they are (names, email, address); where to send money is added separately as a [destination](/api-reference/recipients/add-a-destination). - [Retrieve a recipient](https://docs.talescria.com/api-reference/recipients/retrieve-a-recipient.md): One recipient, with the destinations they can be paid at. - [Add a destination](https://docs.talescria.com/api-reference/recipients/add-a-destination.md): Adds a way to pay a recipient: a bank account, mobile money wallet and so on, in one currency. - [Get destination requirements](https://docs.talescria.com/api-reference/recipients/get-destination-requirements.md): The fields a destination needs. With no `method` and `currency`, lists every supported corridor. With both, returns that corridor's fields and schemes. - [List banks](https://docs.talescria.com/api-reference/recipients/list-banks.md): The banks a payment can reach in a country, for a bank picker. Pass `q` to narrow by name or code. - [List payment reasons](https://docs.talescria.com/api-reference/payments/list-payment-reasons.md): The reasons a payment can be made for. Send one as `reason` when you [send a payment](/api-reference/payments/send-a-payment). - [Create an FX quote](https://docs.talescria.com/api-reference/payments/create-an-fx-quote.md): Locks an exchange rate for a payment to a destination in a currency the source account doesn't hold. - [Retrieve an FX quote](https://docs.talescria.com/api-reference/payments/retrieve-an-fx-quote.md): A quote and whether it is still `active`, `used` or `expired`. - [Send a payment](https://docs.talescria.com/api-reference/payments/send-a-payment.md): Pays a recipient from one of your accounts. The amount is reserved first; if the payment network refuses, the reservation is released and your balance is as it was. - [Retrieve a payment](https://docs.talescria.com/api-reference/payments/retrieve-a-payment.md): A payment as it stands. Poll this while `status` is `pending` or `processing`. - [Quote a transfer between your accounts](https://docs.talescria.com/api-reference/transfers/quote-a-transfer-between-your-accounts.md): Prices moving money between two of your accounts in different currencies. Give exactly one amount: what leaves (`amountFromMinorUnits`) or what arrives (`amountToMinorUnits`). - [Transfer between your accounts](https://docs.talescria.com/api-reference/transfers/transfer-between-your-accounts.md): Moves money between two of your own accounts. - [Retrieve a transfer between your accounts](https://docs.talescria.com/api-reference/transfers/retrieve-a-transfer-between-your-accounts.md): A transfer between your accounts as it stands. Poll while `status` is `pending`. - [List payment links](https://docs.talescria.com/api-reference/payment-links/list-payment-links.md): Your payment links, newest first. - [Create a payment link](https://docs.talescria.com/api-reference/payment-links/create-a-payment-link.md): Makes a link anyone can open to pay you by card, into one of your accounts. Share the returned `url`. - [Retrieve a payment link](https://docs.talescria.com/api-reference/payment-links/retrieve-a-payment-link.md): One payment link, with how many payments it has taken. - [Archive a payment link](https://docs.talescria.com/api-reference/payment-links/archive-a-payment-link.md): Switches a link off. New payers are refused; a payment already in progress isn't interrupted, and a paid link stays paid. - [List customers](https://docs.talescria.com/api-reference/customers/list-customers.md): Your customers, oldest first. Deleted customers are left out. - [Create a customer](https://docs.talescria.com/api-reference/customers/create-a-customer.md): Adds someone who pays you. You can invoice them and make payment links for them. - [Retrieve a customer](https://docs.talescria.com/api-reference/customers/retrieve-a-customer.md): One customer. - [Update a customer](https://docs.talescria.com/api-reference/customers/update-a-customer.md): Changes the fields you send. A field you leave out is unchanged; `null` clears `phone` or `address`. - [Delete a customer](https://docs.talescria.com/api-reference/customers/delete-a-customer.md): Removes a customer from your list. Links and invoices made for them still name them. - [List invoices](https://docs.talescria.com/api-reference/invoices/list-invoices.md): Your invoices, newest first. - [Create an invoice](https://docs.talescria.com/api-reference/invoices/create-an-invoice.md): Issues an invoice to one of your customers and, unless `notify` is `false`, emails it with a link to pay by card. - [Preview the next invoice number](https://docs.talescria.com/api-reference/invoices/preview-the-next-invoice-number.md): The number the next invoice is likely to get. It isn't reserved. - [Retrieve an invoice](https://docs.talescria.com/api-reference/invoices/retrieve-an-invoice.md): One invoice. `status` is `unpaid`, `overdue`, `paid` or `void`. An overdue invoice can still be paid. - [Void an invoice](https://docs.talescria.com/api-reference/invoices/void-an-invoice.md): Withdraws an unpaid invoice. Its payment page stops taking payments. - [Resend an invoice](https://docs.talescria.com/api-reference/invoices/resend-an-invoice.md): Emails an open invoice to the customer again. - [List recurring series](https://docs.talescria.com/api-reference/invoices/list-recurring-series.md): Your recurring invoice series. - [Create a recurring series](https://docs.talescria.com/api-reference/invoices/create-a-recurring-series.md): Issues an invoice to a customer on a schedule: `weekly`, `biweekly`, `monthly` or `quarterly` from `startDate`, until `endDate` if you give one. - [Retrieve a recurring series](https://docs.talescria.com/api-reference/invoices/retrieve-a-recurring-series.md): One series and the invoices it has issued. - [Cancel a recurring series](https://docs.talescria.com/api-reference/invoices/cancel-a-recurring-series.md): Stops a series. Invoices already issued are unchanged. - [Create a checkout session](https://docs.talescria.com/api-reference/checkout/create-a-session.md): Start a hosted payment page for an amount your server sets. - [Retrieve a checkout session](https://docs.talescria.com/api-reference/checkout/retrieve-a-session.md): Check whether a checkout session has been paid. ## OpenAPI Specs - [openapi](/api-reference/openapi.yaml) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.