Step-by-step guide

Entering Your Stripe Keys into Poyenics Portal

Welcome to our guide on securely entering your Stripe keys into the Poyenics Portal. Stripe is a leading online payment processing platform used by businesses worldwide to process online payments securely. Stripe keys are crucial for payment processing and safeguarding them is of utmost importance. In this guide, we will walk you through the process of adding these keys directly to our platform. Currently, our guide focuses on using the secret and publishable keys directly. However, we are actively working to support Stripe Restricted keys, and once implemented, we will update this guide accordingly.

Image alt attribute

Secure Key Management

Protecting Your Stripe Keys


Stripes keys are necessary for payment processing, and it is important to protect and safeguard these keys. The recommended option is to open both Stripe and our admin portal in separate browser tabs and copy your keys directly from Stripe into our platform. This reduces the risk of interception or accidental exposure. Once these keys are entered and saved inside our platform, they are being kept in encrypted format and used securely during payment processing.

  • Do not store your Stripe keys or any sensitive credentials in unsecured locations such as files on your computer.
  • Do not share Stripe keys via email, text message or any communication channel. Instead, directly enter them into the secure target platform or secure environments intended for payment processing.
  • After copying and pasting the keys into our platform, clear your clipboard by copying random text to prevent accidental exposure.
  • If you suspect any unusual activity or believe a key may be compromised, immediately rotate your Stripe keys using the "Roll key" button, and update them on our platform.
  • Always use a secure and trusted network or internet connection when accessing Stripe, our platform or entering keys. Avoid public Wi-Fi to reduce interception risks.
  • Periodically review your Stripe account activity for any suspicious transactions or logins.
  • Keep your devices secure by using antivirus software and ensuring your operating systems and applications are updated to protect against vulnerabilities.
  • Even without signs of compromise, establish a routine schedule for rotating your keys to minimize risk.

Retrieving Test Keys from Stripe:

Test keys are used for test purposes. Follow the following steps to retrieve test keys from Stripe dashboard:

  1. Sign in to your Stripe account.
  2. Once you are signed in, you can browse to the following link, https://dashboard.stripe.com/test/apikeys to access the "API Keys" section of the Stripe Developer dashboard.
  3. On this page, you can see a section titled as "Standard Keys". Find the "Publishable Key" and "Secret Key". These are your test publishable and secret keys you need to enter into the payment processing platform for test purposes.


Retrieving Live Keys from Stripe:

Live keys are used for real transaction processing. Follow the following steps to retrieve live keys from Stripe dashboard:

  1. Sign in to your Stripe account.
  2. Once you are signed in, you will be taken to the Stripe dashboard.
  3. On the dashboard, locate the "Test mode" toggle at the top bar of the dashboard. This toggle allows you to switch between the Test and Live mode. When test mode is off, you are accessing real or production data. When test model is on, you are using test data. Stripe also shows a notification bar stating "You are using test data. No real transaction will be processed". 
  4. In order to retrieve real or production keys, make sure this "Test mode" toggle is off.
  5. Before accessing your keys, please ensure you thoroughly read the "Protecting Your Stripe Keys" section of this guide and adhere to the recommended best practices.
  6. Please carefully read the section "Protecting Your Stripe Keys" on this guide before accessing this keys and follow the practices we have mentioned.
  7. Now go to the "API Keys" section under the Stripe Developer dashboard or visit https://dashboard.stripe.com/apikeys.
  8. When the API Keys page is open, in the "Standard Keys" section, you can find your live Publishable and Secret keys. You can click "Reveal live key" to view the Secret key.
  9. You can copy/paste your live secret and publishable key on your payment processing platform such as our platform. 


Entering Stripe Keys into Poyenics Portal

  1. Login to Poyenics Portal at https://portal.poyenics.com/ with your user account.
  2. Once you are logged in, choose the relevant website/business once logged in.
  3. When you are in our admin dashboard, go to "Settings" and then "General Settings".
  4. Once "General Settings" section is open, click on the "Edit" button" and then click on the "Design" button to view all settings.
  5. Now that all settings are open, click on the "Stripe Payment Gateway" tab.
  6. On the "Stripe Payment Gateway" tab, you will see the stripe settings. enter the test and live "Secret" and "Publishable" keys in their respective tabs and fields. Once saved, the keys will appear as stars (as they are encrypted) and be stored securely. Hover over the green shield icon next to each field label for more information. 
  7. Under "Current Active Key" choose "Test Keys" for testing or "Live Keys" for real transactions.

Notes regarding the "Current Active Key" setting:

  • If your system is in real mode but "Test Keys" are selected, no real payments will be processed.
  • Make sure the "Current Active Key" setting matches your systems current state. 


Key Reminders:

  • Always handle your Stripe keys carefully to prevent unauthorized access.
  • Rotate your keys immediately if you suspect any compromise.
  • Regularly monitor your account for unusual activity.


We have made every effort to provide the most up-to-date and accurate instructions. However, please be aware that processes may change over time. If you encounter any discrepancies or error in this documentation, need the latest updates or you have any questions or need further assistance, please contact our team at info@poyenics.com.