| |
| gateways:worldline [2025/06/24 15:15] – created adam | gateways:worldline [2025/06/24 15:15] (current) – [Setting Up Worldline Hosted for Foxy] adam |
|---|
| Once you have a Worldline account configured, you can follow these steps to get your account connected to Foxy | Once you have a Worldline account configured, you can follow these steps to get your account connected to Foxy |
| |
| - In your Foxy administration, navigate to the Settings > Payments section | - In your Foxy administration, navigate to the Settings > Payments section |
| - Select your desired payment set (if you just have one, it will just be the "Default Payment Method Set") | - Select your desired payment set (if you just have one, it will just be the "Default Payment Method Set") |
| - Add a new payment method, and select "Worldline Hosted" | - Add a new payment method, and select "Worldline Hosted" |
| - In a new tab, go to your Worldline account administration and log in | - In a new tab, go to your Worldline account administration and log in |
| - In the Worldline administration, navigate to Developers > Payment API | - In the Worldline administration, navigate to Developers > Payment API |
| - 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. | - 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. |
| - Back in the Worldline administration, click the "Add API key" button | - Back in the Worldline administration, click the "Add API key" button |
| - 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 | - 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 |
| - Back to the Worldline administration, copy the API key ID. In the Foxy administration, paste the value into the API key ID field | - Back to the Worldline administration, copy the API key ID. In the Foxy administration, paste the value into the API key ID field |
| - Back in the Worldline administration, navigate to Developer > Webhooks | - Back in the Worldline administration, navigate to Developer > Webhooks |
| - 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. | - 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. |
| - Back in the Worldline administration, still on the Webhooks page, click the "Add webhook endpoint" button | - Back in the Worldline administration, still on the Webhooks page, click the "Add webhook endpoint" button |
| - 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''. | - 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''. |
| - Save the webhook endpoint settings | - Save the webhook endpoint settings |
| - 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. | - 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. |
| |
| ===== Testing ===== | ===== Testing ===== |
