Support

The installation of Scalapay on a VTEX site requires a few mandatory step.

Set up the Scalapay Payment Provider in VTEX
Configure the Payment Provider settings
Set up the Frontend Payment Conditions



❤ Set up the Scalapay Payment Provider in VTEX


To integrate Scalapay, you need to follow the steps below.

  1. Install the scalapay.scalapay-connector App on your VTEX account.

vtex install scalapay.scalapay-connector 1.0.3

  1. Go to your VTEX Admin Panel (Back Office) and go to Apps.


  1. Go to App Management.


  1. Search for Scalapay Connector and click on Settings.


  1. Enter your Live API Key.


  1. Click Save to apply the changes.

📘

IMPORTANT

How to find your Live API key

  • Log in to the Scalapay Merchant Portal.
  • Go to the Developer section of your account.
  • Copy your Live API key (it starts with sp_).
  • This key is required to connect your VTEX store to Scalapay in production mode.



❤ Configure the Payment Provider settings


Go to your Back Office:


  1. Navigate to Store Settings > Payment > Providers and click the New Provider button.


  1. Search for Scalapay Connector and add it.


  1. Set the provider name based on the payment method:
  • For Pay in 3: Scalapay Connector PAY IN 3
  • For Pay in 4: Scalapay Connector PAY IN 4


  • Uncheck "Enable test mode" to activate production mode.


  • Under Automatic settlement, select:
    "Automatic capture immediately after payment authorization"


  • Under Product Type, choose:
    Pay in 3 (or Pay in 4 for the second configuration)


  • Click Save to apply the settings.

📘

IMPORTANT

Repeat the above steps to configure the provider for Pay in 4, using the appropriate name and product type.





❤ Set up the Frontend Payment Conditions


To set up the payment conditions for the frontend, follow these steps:


  1. Go to Store Settings > Payment > Settings.


  1. Click Add new payment condition for.


  1. Select Scalapay Pay in 3.


  1. Under Process with provider, choose Scalapay Connector PAY IN 3 (previously created).


  1. Check the Active box.


  1. Enter a custom display name:
  • Use Pay in 3 for the Pay in 3 option.
  • Use Pay in 4 for the Pay in 4 option.


  1. Click Save to apply the configuration.

📘

IMPORTANT

Repeat these steps to set up Pay in 4, selecting the appropriate provider and display name.