Skip to main content
This page is the consolidated Single Source of Truth for developers integrating the Tonder Withdrawals API, providing all necessary details, constraints, and process flows.
Authentication RequiredEvery single request to the Withdrawals API requires authentication using a token in the Authorization header. This applies to all API requests, Postman requests, and testing scenarios.Include this header in every request:
Authorization: Token YOUR_API_KEY
Replace YOUR_API_KEY with the token provided in the Developers section of the Tonder platform.Requests without proper authentication will return a 401 Unauthorized error.

​
What is the Withdrawals API?

The Tonder Withdrawals API enables you to send payouts and withdrawals to beneficiaries, supporting multiple transfer methods including SPEI bank transfers and debit card deposits. The API provides a unified interface for processing withdrawals with real-time status updates via webhooks.

​
Key Features

  • Multiple Transfer Methods: Support for SPEI bank transfers and debit card instant deposits
  • Real-time Status Updates: Webhook notifications for withdrawal status changes
  • Comprehensive Audit Trail: Complete status change history for each withdrawal
  • Secure Authentication: Token-based authentication with HTTPS encryption
  • Flexible Fee Models: Support for both user-paid and merchant-paid fee structures

​
Quick Start

  1. Set up your environment: Configure your API credentials for Stage or Production environments
  2. Get your API token: Retrieve your API token from the Developers section in the Tonder platform
  3. Authenticate your requests: Learn about authentication requirements - every single request requires the Authorization header
  4. Create your first withdrawal: Follow the create withdrawal guide
  5. Handle webhooks: Set up webhook listeners to receive status updates
Authentication RequiredAll API requests, including Postman requests, require the Authorization: Token YOUR_API_KEY header. Get your token from the Developers section of the Tonder platform.

​
Next Steps