Sandbox Environment
Luxfin provides a sandbox environment for you to test your integration before going live. The sandbox behaves identically to the production API but does not process real payments.
🌐 Base URLs
| Environment | Base URL |
|---|---|
| Sandbox | https://sandbox.luxfintech.org |
| Production | https://luxfin.org |
🔑 Sandbox Credentials
- Log in to your admin dashboard to get your sandbox API Key and API Secret — they are generated automatically when you register.
- Use these credentials to log in to the sandbox dashboard.
Sandbox and production credentials are not interchangeable. Make sure you are using the correct credentials for each environment.
🛒 How to Use the Sandbox
The sandbox dashboard provides a complete testing workflow in three steps: Create Order → Open Payment Page → Simulate Payment.
Your Test Credentials
Located on the right side of the dashboard. Here you can view your Test API Key and Test Secret. Use the Copy button to copy your API Key, or the Show button to reveal your Secret.
Step 1: Create a Test Order
Use the NEW TEST PAYMENT form on the dashboard to create a test order:
| Field | Description | Required |
|---|---|---|
| Payment Method | Select a payment method (e.g., Venmo, PayPal) | Yes |
| Amount | The payment amount | Yes |
| Currency | Currency code (e.g., USD) | Yes |
| Customer | Customer email address | Yes |
| Product | Product description | No |
Click Create Test Order to submit.
Step 2: Open Payment Page & Simulate Payment
After creating an order, it will appear in the YOUR TEST ORDERS section with a PENDING status. For each pending order you can:
- Enter a temporary webhook URL in the Test Webhook URL field to receive webhook notifications at a custom endpoint, or leave it empty to use your account's default webhook URL.
- Click the Pay button to simulate a successful payment.
- If Webhook on pay is checked, a webhook notification will be sent automatically after you click Pay. If unchecked, you can manually trigger the webhook by clicking the webhook button that appears on each paid order.
- Click Refresh to update the order list.
Step 3: Verify the Webhook
If Webhook on pay is enabled, Luxfin will send a webhook notification to your configured webhook URL after you simulate the payment. Verify that your server correctly receives and processes the webhook. See the Webhook guide for details.
Additional Tools
- API Reference — Expandable section with API documentation for reference.
- Activity Log — View a log of all sandbox actions and events.
✅ Going Live
When you're ready to accept real payments:
- Replace the sandbox base URL with
https://luxfin.org. - Use your production API Key and API Secret.
- Verify your webhook endpoint is configured for the production environment.
We recommend testing the full flow — payment creation, redirect, and webhook verification — in sandbox before switching to production.