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, 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)UPI, Net Banking, Wallets (Paytm)
AfricaEgypt (EGP), Algeria (DZD)Fawry, Vodafone Cash, Algérie Poste
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
    Once validated in Sandbox, switch your Base URL to the Production environment (merchant-gw.tradexworld.com/v1) and enable live transactions.

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.