Sandbox

Sandbox mode lets you build and test your integration without moving real money. Use test keys (pk_test_ / sk_test_) to access sandbox mode — everything else works the same as production.

Test vs live keys

Both key types use the same base URL: https://api.elebne.ai/api/v1. The key prefix determines whether you are in sandbox or production mode.

Magic amounts

Use these special amounts (in centimes) to test specific scenarios:

Example — creating an intent that will fail on payment:

curl -X POST https://api.elebne.ai/api/v1/dev/intents \
  -H "Authorization: Bearer sk_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Idempotency-Key: test-fail-$(date +%s)" \
  -d '{"amount": 99901, "label": "Test failure"}'

When you simulate payment on this intent, it will return a failure status instead of completing.

Sandbox shops

When you create products using test keys, they are placed in a hidden sandbox shop that is invisible to real customers browsing the Elebne marketplace. This lets you test your catalog sync without polluting your live storefront.

• Sandbox products, orders, and intents are completely isolated from production data.
• You can create, update, and delete sandbox products freely.

Simulating payments

In sandbox mode, you can simulate a customer completing a payment without needing a real Elebne wallet:

POST /dev/intents/:referenceNumber/simulate-payment

This moves the payment intent from PENDING to COMPLETED (or FAILED if you used a magic amount) and fires the corresponding webhook events.

Simulating orders

Similarly, you can simulate a customer placing an order in your sandbox shop:

POST /dev/store/orders/simulate

This creates a test order and fires an order.new webhook event, letting you test your order fulfillment flow end-to-end.

Data retention

Sandbox data is automatically cleaned up after 30 days. If you need persistent test data, recreate it periodically or use your integration to seed it on demand.

Limitations

Sandbox mode has a few differences from production:

• No real money movement. Wallet balances are not affected.
• No customer notifications. Payers do not receive SMS or push notifications.
• No real settlement. Funds do not appear in the merchant's Elebne balance.
• Data expires. Sandbox data is cleaned after 30 days.

Next steps

• Webhooks — Test webhook delivery in sandbox mode
• Going Live — Checklist for switching to production
• Environments — Full comparison table