Key Features
Key features of the Direct API include:Single Endpoint Processing
Handle payments and withdrawals through one API.
Regional Payment Methods
Native support for SPEI, OXXO, Mercado Pago, and more.
Instant Response
Real‑time processing with immediate status updates.
Simplified Integration
Reduce development time from weeks to days.
Comprehensive Coverage
Cards, bank transfers, cash, and digital wallets.
Getting Started Process
Here are the steps to get started with Tonder’s Direct API.1
Sign in or request access
Sign in at app.tonder.io or request an account via your Tonder CSM.
2
Get API credentials
Retrieve your API key and secret from the developer section.
3
Test in Sandbox
Use the stage environment to validate your flow end‑to‑end.
4
Go live
Complete production setup and go‑live checks.
Authentication
All API requests require authentication using API keys, and with HMAC SHA256 signatures when specified.Base URLs
The base URL to use for your requests is the following:| Environment | Base URL | Purpose |
|---|---|---|
| Stage | https://stage.tonder.io/api/v1/ | Testing and development |
| Production | https://app.tonder.io/api/v1/ | Live transactions |
For detailed information on endpoints, request/response formats, and error handling, see the API Reference section below. It covers everything from card tokenisation and core endpoints to webhooks and status checking.
API Architecture
Unified Processing Endpoint
The API uses a single/process/ endpoint that handles both payments and withdrawals based on the operation_type field in the request.
Supported Payment Methods
Cards
Credit and debit cards with tokenization support.
SPEI
Mexican bank transfers (real‑time).
OXXO
Cash payments at convenience stores.
Mercado Pago
Digital wallet payments.
SafetyPay
Alternative cash payment methods.
Supported Transfer Methods
SPEI
Bank account transfers (same‑day processing).
Debit Card
Direct card deposits (instant).
Documentation Structure
This documentation is organised into the following sections:API Reference
API Reference
- Card Tokenisation – Secure card data handling
- Core Endpoints – Main API operations
- Request Structure – API request formatting
- Response Format – API response handling
- Status Checking – Transaction monitoring
Payment Processing
Payment Processing
- Payment Methods – All supported payment options
- Withdrawals – Payout processing
Integration
Integration
- Webhooks – Real-time notifications
- Error Handling – Error management
Regional Reference
Regional Reference
- Mexican Banking – Regional requirements
Resources
Resources
- Production Readiness – Go-live checklist
- Rate Limits – API usage limits
- Support & Resources – Help and resources
Support Channels
If in need of support, you can contact us via the following channels:| Channel | Response Time | Best For |
|---|---|---|
| Email Support | 24 hours | Integration questions |
| Developer Documentation | Instant | API reference and guides |
| Status Page | Real-time | Service availability |
For more details on support options and getting help, check out the Support & Resources page.
Useful Links
Some useful links to help you with your integration include:| Resource | Link/Contact | What it’s for |
|---|---|---|
| Dashboard | https://app.tonder.io | Manage transactions and API keys |
| API Status | https://status.tonder.io | Check real-time service status |
| Developer Support | developers@tonder.io | Get help with integration questions |
Next Steps
- Quick Start Guide – Get stuck in with a hands-on setup
- Payment Methods – See which payment options are supported
- Core Endpoints – Check out the main API specs
- Webhooks – Set up real-time notifications