Quick start

The Cashela API lets your business collect payments (Pay-In) and send payouts (Pay-Out) through one REST API with JSON over HTTPS. Both products use the same credentials and the same authentication.

Get started

1. Open a Cashela Business account. Register at cashela.com/business-home and complete the business verification.

2. Create your sandbox API key. In your dashboard, open the Developer Portal. Your sandbox is created automatically. Create a key and store its API secret: it is shown only once. See Get started.

3. Make your first call. Every request uses HTTP Basic authentication: your api_key is the username and your api_secret the password.

   curl https://sandbox-api.cashela.com/api/v1/pay-in/deposit-creation/countries \
     -u "$CASHELA_API_KEY:$CASHELA_API_SECRET" \
     -H "Accept: application/json"

4. Build and test in sandbox. Sandbox moves no real money. Follow the Pay-In integration flow or the Pay-Out overview, verify your webhooks and handle errors.

5. Go live. When the go-live readiness checks are green, request production access in the Developer Portal. After approval, create a production key and switch the base URL. See Go live.

Environments

Environment	Base URL	Credentials
Sandbox	https://sandbox-api.cashela.com	Keys from the Sandbox card of the Developer Portal
Production	https://production-api.cashela.com	Keys from the Production card, after your go-live request is approved

Caution

Sandbox and production credentials are separate: a key only works in its own environment. Keep your api_secret on your servers; it also signs the webhooks Cashela sends you.

Products

Product	What it does	Start here
Pay-In API	Collect payments from your customers with local methods (bank transfer, cash voucher, mobile money) and cards, on a Cashela-hosted checkout.	Pay-In overview
Pay-Out API	Send money to recipients abroad.	Pay-Out overview

Wallet, gift cards, bill payments and mobile top-ups are coming soon.

Conventions

• Country codes: ISO 3166-1 alpha-3 (MEX, CHL, BRA).
• Currency codes: ISO 4217 (USD, MXN).
• Field names: snake_case.
• Send your own X-Trace-Id header on each request and quote it to support.

Need help?

Contact Cashela support with the X-Trace-Id of the request and the transaction reference.