Documentation

Comprehensive guides for integration, API reference, and best practices.

View Documentation

Technical Support

Get help from our developer support team for integration issues.

Contact Support

Account Help

Questions about your merchant account, credentials, or billing.

Account Support

Frequently Asked Questions

How do I get my Dejavoo TPN and Auth Token?

Log in to the iPOSpays Portal at portal.ipospays.com. Your TPN (Terminal Provider Number) is displayed in your merchant dashboard. To generate an Auth Token, go to Settings > API Keys and create a new JWT token. Make sure the TPN in your token matches your DEMO_TPN environment variable.

Why am I getting "Invalid token" errors?

Common causes: 1) The TPN in your Auth Token doesn't match your DEMO_TPN. Decode your JWT at jwt.io to verify. 2) Line breaks in your token - when pasting into Railway, ensure it's a single line with no spaces or newlines. 3) Using a sandbox token in production or vice versa.

How do I test payments in sandbox mode?

Use test card number 4111 1111 1111 1111 with any future expiration date and any 3-digit CVV. For declined transactions, use 4000 0000 0000 0002. Make sure your DEJAVOO_ENV is set to "sandbox".

How do I deploy to production?

1) Get production credentials from Dejavoo (different TPN and token than sandbox). 2) Set DEJAVOO_ENV=production. 3) Update BASE_URL to your production domain. 4) Set strong values for DEBUG_SECRET, ADMIN_SECRET, and other security variables. 5) Configure your database connection string.

Can I use this gateway with my own branding?

Yes! The SDK supports custom theming. You can set your brand colors, logo, and button text when creating checkout sessions. The Dejavoo hosted payment page also supports personalization options for merchant name, description, and colors.

Still Need Help?

Our support team is here to help you succeed.