Integrating Teya into your own website or app allows you to securely process online Payments. This guide helps you and your developer choose the right setup, generate your API credentials, and test your systems before taking them live. Review these steps to understand how to connect your website to Teya.
Choose your integration path
You have two main paths to integrate Teya online payments. Share these options with your developer to decide which works best for your business.
Hosted Checkout Your website creates a checkout session using the Teya API. When your customer is ready to pay, you redirect them briefly to Teya's secure checkout page. Once the Payment is complete, they return to your site.
When to choose it: This is the fastest method to build. Choose this path if you have limited developer resources. It is the right default for most custom integrations.
Embedded Components You embed pre-built Teya payment fields directly into your checkout page. Your customer never leaves your website to complete their Payment.
When to choose it: Choose this path when keeping the customer on your own page is highly important. Setting this up requires more code than the redirect path, so ensure you have enough developer time to invest.
How do I get my API credentials and webhooks?
To connect to our API endpoints, you need to generate credentials. To receive updates about your transaction outcomes, you need to set up webhooks.
You can configure both easily using the Teya Business Portal. The same approach applies for both Staging and Production environments.
Follow these steps:
Open your Teya Business Portal.
Go to Settings.
Select the store you want to set up.
Click on Integrations.
Generate your credential sets and configure your webhooks.
Test and launch your integration
Your developer will build and test the integration on a Staging environment first. If you have not chosen between Hosted Checkout and Embedded Components yet, compare them here.
Important: The exact method to reach your Teya contact or access the specific test card numbers is currently missing from this guide. Reach out to the support team if you do not have a dedicated Teya contact.
Next steps for testing:
Set up Staging: Your Teya contact will help you set up the Staging environment.
Run test transactions: Use test credentials and test cards to simulate transactions.
Verify the flow: Test the full payment process, issue a refund, and ensure your webhook flow works correctly.
Move to Production: Once you successfully test all processes, you can move your integration to Production and accept live Payments.
Developer resources: For full integration guides, concrete steps, API references, and code samples, send your developer to Teya Developer Guide .
Need more help?
Understand Hosted Checkout
Understand Embedded Components
Choose the right online payment option