Worldline Hosted

Once you have a Worldline account configured, you can follow these steps to get your account connected to Foxy

1. In your Foxy administration, navigate to the Settings > Payments section
2. Select your desired payment set (if you just have one, it will just be the “Default Payment Method Set”)
3. Add a new payment method, and select “Worldline Hosted”
4. In a new tab, go to your Worldline account administration and log in
5. In the Worldline administration, navigate to Developers > Payment API
6. Near the top right of the page, you'll see a value labelled “PSPID”. Copy this value and in the Foxy administration, paste it into the “Merchant ID” field.
7. Back in the Worldline administration, click the “Add API key” button
8. The API key secret will only be shown for a short time - so click the “copy” icon to the right of the secret value to copy it to your clipboard. In the Foxy administration paste, the value into the API secret key field
9. Back to the Worldline administration, copy the API key ID. In the Foxy administration, paste the value into the API key ID field
10. Back in the Worldline administration, navigate to Developer > Webhooks
11. Click the “Generate webhook keys” button to generate a new webhook secret key for your account. This value will only be shown once (but can be re-generated if needed). Copy the value shown into the “Webhook Secret” input in the Foxy administration.
12. Back in the Worldline administration, still on the Webhooks page, click the “Add webhook endpoint” button
    1. The URL for the webhook endpoint will look like https://YOUR-STORE.foxycart.com/ipn.php. You will need to set the correct store domain depending on your store settings. If your Foxy store domain was example.foxycart.com, you would set the URL to be https://example.foxycart.com/ipn.php. If you had a custom subdomain set up for your store though, and it was instead something like secure.yourstore.com, the URL would be https://secure.yourstore.com/ipn.php.
13. Save the webhook endpoint settings
14. Switch back to the Foxy administration, and at this time you should have completed all the fields. Save the new gateway for your store to enable it as a payment method.

If you want to utilise a specific custom template variant from Worldline for your hosted payment page, you can specify the code for this as part of the options within the Foxy administration Worldline configuration.

In the Worldline admin, under Developer > Branding, copy the “Variant name” and paste it into the “Template variant” field for your Worldline payment settings in the Foxy admin.

You can create a test account for Worldline Hosted on their site here: https://signup.direct.preprod.worldline-solutions.com.

With your account, you can complete the steps to integrate with Foxy above - ensuring you specify the values into the test fields.

Contact Worldline for info. Know more? Feel free to edit this page with info.

Contact Worldline for info. Know more? Feel free to edit this page with info.

If you have tips, experience, or helpful notes related to this gateway that would benefit others, please add them below, including your name and the date. We reserve the right to edit or remove comments that don't add value to this page.