Using our VTEX plugin doesn't require downloading additional software or complicated installation. Before moving on to plugin configuration, make sure you have the following:
- VTEX account (manage the entire digital commerce experience in one place via Admin tool)
- Worldline account and access to the Configuration Center (please get in touch with us to set it up)
Plugin configuration
- Access the VTEX Admin panel
- Go to Payments > Settings
- In Gateway Affiliations, click on the green + button
- Scroll down and search for the worldline.globalcollect connector, click on it
- By completing the previous step, our app will be automatically installed
- You'll get the following screen, that needs to be adjusted:
- Finalize the configuration. Please note that VTEX doesn't allow to have optional/mandatory fields, so please complete the setup of all fields (even if logically not applicable to your processing).
Access Configuration Center of the applicable environment (sandbox, pre-production, production) to gather some of the required information. Check the guides on how to use the Configuration Center, and how to set up your webhooks.
| VTEX | Our platform |
|---|---|
| Application key | API key ID of the correct environment (sandbox, pre-production or production). You can find this information your Configuration Center. |
| Application token | Secret API key of the correct environment (sandbox, pre-production or production). You can find this information your Configuration Center. |
| Capture type | Depending on how you'd like to capture the transaction, you can choose direct or delayed capture type |
| Environment | The environment you'd like to use (note that this defines our Worldline endpoints) |
| Merchant ID | Your Worldline merchant ID. You can find this information your Configuration Center. |
| Payment subdomain | Applicable if you use MyCheckout hosted payment pages. Add your desired payment sub-domain, for example "payment". As VTEX doesn't allow us to make this field optional, please set include this in the configuration. |
| Webhook key ID | Key ID under Webhooks keys of the correct environment (sandbox, pre-production or production). You can find this information your Configuration Center. |
| Webhook secret key | Secret key under Webhooks keys of the correct environment (sandbox, pre-production or production). You can find this information your Configuration Center. |
| 3DS mode | Enabled/Disabled. Please note that Worldline's 3DS provider has to be configured on our side to make it work, you can align with your integration manager on this requirement. |
| posID | You can direct the transactions to specific acquirers configured in your Worldline account. You can request the posID from your integration manager. Only one posID should be configured per affiliation, while you can add multiple affiliations with different posIDs. |
| Soft descriptor | Your desired descriptor passed on with the transaction. |