Skip to main content
Welcome to the meCash API Reference! Everything here runs against Sandbox, so line up the essentials below and you can be testing endpoints in minutes.

​
Before you start

  1. Copy your Sandbox API key from Developers → API Keys (environment toggle set to Sandbox).
  2. Add every server/VPN IP to Developers → IP Whitelisting → Sandbox—unlisted IPs return 403.
  3. Use the sandbox base URL https://sandboxapi.me-cash.com plus JSON headers (Content-Type / Accept).

​
Getting Started

Use the built-in Try it panel to send real Sandbox calls without leaving the docs:
1

Pick an endpoint

Choose an endpoint in the sidebar (e.g., Wallets → Get All Wallets) and open the Try it drawer.
2

Authenticate once

Select the Sandbox environment, paste your API key under Authentication, and Mintlify auto-adds the header for every request.
3

Send & inspect

Edit path/query/body fields, click Send, then review the live response, headers, and generated cURL snippet you can reuse elsewhere.
Heads-up: 401 means the API key is missing or expired. 403 almost always indicates the calling IP still needs to be whitelisted in Sandbox.

​
Testing & Simulation

Before going live, use our sandbox simulation tools to verify your integration’s behavior.

Fund Virtual Account

Simulate incoming transfers to test your collection flow and webhooks.

Simulate Payout Failure

Trigger payout.failed webhooks by using “fail” in the transaction remark.

​
API Endpoints

Explore our API categories to find the endpoints you need.

​
FIAT API

Wallets

Manage your multi-currency wallets.
  • Get all wallets
  • Check wallet balances

Quotes

Create real-time quotes for currency conversions.
  • Create quotes
  • Get quote details

Payouts

Send payments to recipients globally.
  • Create payouts
  • Track payout status

Transactions

Track and monitor your transactions.
  • Get transaction details
  • View transaction history

Virtual Accounts

Create accounts to collect payments.
  • Generate static & dynamic accounts
  • Track incoming payments

​
Core Concepts

​
Base URL

All development and testing should be done using our Sandbox environment.

Sandbox Base URL

https://sandboxapi.me-cash.com

​
Response Format

All API responses follow a consistent JSON format for success and error states. 
{
  "status": "success",
  "message": "Operation completed successfully",
  "data": {
    // Response data here
  }
}

​
Error Responses

Error responses include detailed information: 
{
  "status": "error",
  "errorCode": "INVALID_PARAMETER",
  "message": "A request parameter is invalid."
}

​
Rate Limits

Standard Limits

  • 100 requests per minute per API key.
  • 1000 requests per hour per API key.
  • 10,000 requests per day per API key.

Higher Limits

Contact support for higher rate limits based on your business needs and volume requirements.

​
Webhooks

Stay updated with real-time notifications using webhooks:
  • Payout Events: Payment status updates, completion notifications.
  • Collection Events: Incoming payment notifications.
  • Virtual Account Events: Account creation and payment received.
  • All webhooks are signed with HMAC-SHA256.
  • Verify webhook signatures to ensure authenticity.
  • Use HTTPS endpoints for webhook URLs.

​
Support

Documentation

Comprehensive guides and tutorials.

Community

Join our Discord community for help and discussions.

Support

Get direct support from our team
Ready to start building? Use the interactive playground above to test the API, or dive into the specific endpoint documentation for detailed implementation guides.