Skip to main content

Tradex World Payment Gateway API Documentation

Version: v1.0 | Last Updated: March 2026​

🚀 Welcome to Tradex World Developers Portal​

Thank you for choosing Tradex World as your payment infrastructure partner. This documentation serves as the comprehensive technical guide for integrating our Payment Gateway and Payout APIs into your applications, e-commerce platforms, or fintech solutions.

At Tradex World, we specialize in enabling seamless cross-border and domestic commerce by leveraging Alternative Payment Methods (APMs) across high-growth emerging markets. Unlike traditional gateways reliant solely on credit cards, our infrastructure is built to capture the true digital payment landscape of India, Egypt, Morocco, Algeria, Turkey and beyond.

🌍 Why Integrate with Tradex World?​

Our API architecture is designed for flexibility, security, and deep regional localization. Here is what sets us apart:

  • APM-First Architecture: We prioritize local payment preferences (UPI, Fawry, Wallets, Bank Transfers) over generic card processing, resulting in higher conversion rates in target regions.
  • Flexible User Flows: Support for both Host-to-Host (H2H) embedded experiences and Redirect flows allows you to tailor the checkout experience based on your app's capabilities and user expectations.
  • Payout Capabilities: Beyond collecting payments, we offer a robust withdrawal system allowing merchants to settle funds directly to bank accounts or wallets globally.
  • Enterprise-Grade Security: We enforce strict authentication protocols including HMAC-SHA256 request signing and integer-based merchant identification to ensure transaction integrity.

📊 Supported Markets & Methods​

Our gateway connects you to the most popular local payment rails. Ensure your integration supports the specific payment_method_type keys required for each region:

RegionKey MarketsPrimary APMs Supported
AsiaIndia (INR), Turkey (TRY)UPI, Net Banking, Wallets (Paytm), Bank Transfer (Turkey)
AfricaEgypt (EGP), Algeria (DZD)Fawry, Vodafone Cash, Bank Transfer (Algeria)
North AfricaMorocco (MAD)CIB Cardless, D17 Digital Payment

🛡️ Security & Compliance Overview​

Security is the cornerstone of our API design. Before writing code, please familiarize yourself with our security model:

  • Authentication: All endpoints require an X-TW-API-Key and a cryptographically signed request body using your secret_key.
  • Merchant Identification: We use integer-based merchant IDs (X-TW-Merchant-Identifier) to prevent routing errors and enhance security.
  • Data Privacy: For APMs, sensitive banking credentials are handled directly between the user's bank/app and our secure gateway.
  • Webhook Verification: All asynchronous callbacks include a signature header that must be verified to prevent spoofed notifications.

🛠️ Getting Started with Integration​

Follow this high-level roadmap to move from sandbox testing to production:

  1. Onboarding & Credentials
    Register your merchant account and obtain your api_key, secret_key, and merchant_identifier.
  2. Implement Authentication
    Build your request signing logic (HMAC-SHA256) to include headers: X-TW-Merchant-Identifier, X-TW-Timestamp, and X-TW-Signature.
  3. Develop Payment Flows
    Implement the Create Payment endpoint. Decide whether you need a Redirect Flow (user leaves site) or Host-to-Host Flow (user stays on app, requires confirmation step).
  4. Handle Webhooks
    Set up an HTTPS endpoint to receive PAYMENT_COMPLETED and POUTLET_SUCCESS events for real-time order status updates.
  5. Go Live
    The production Base URL is https://merchant-gw.trdworld.com/v1. Sandbox traffic uses the same host — test credentials connect to the same endpoint in sandbox mode (no separate sandbox URL).

Ready to build?
Proceed to the Authentication & Signing section to begin configuring your environment, or jump directly to the API Reference for full endpoint details.