Tahweel Merchant
API Documentation
Complete developer guide for integrating Tahweel payment solutions. Accept QR code payments, check transaction status, and process refunds.
Quick Navigation
Jump to the most important sections
API Endpoints
Explore the available API endpoints for Tahweel merchant payment integration
Create Payment
Generate a new payment request with QR code for customers to scan and pay via Tahweel app.
Payment Details
Retrieve complete transaction details including customer info, products, and webhook status.
Payment Status
Check the current status of a payment. Use for polling or as an alternative to webhooks.
Refund Payment
Process a full refund for completed payments. Funds are returned to customer Tahweel wallet.
Base URLs
Choose the appropriate environment for your integration. Use Sandbox for testing and Production for live transactions.
Production
For live transactions
https://connect.tahweel.ioSandbox
For testing & development
https://connect.tahweel.io💡 Same URL, Different Keys: Both environments use the same API endpoint. The environment is automatically detected based on which API credentials you use.