2Checkout

Setting up 2Checkout

Configure notifications and redirects in 2Checkout

1. 1

   In your 2Checkout administration, go to the Webhooks & API section under Integrations.

2. 2

   In the Instant Notification System (INS) section, check Enable INS and click Update. Note that 2Checkout also has settings for IPN, which Foxy doesn't use — only INS.

3. 3

   In the Redirect URL section, check Enable return after sale, set the Return method dropdown to Header redirect, and leave the Approved URL input blank. Click Update.

4. 4

   At the top of the Webhooks & API section, select the INS settings tab. Again, INS and not IPN. If you don't see it, make sure you enabled it in step 2 and that you're looking at the tabs towards the top of the page.

5. 5

   Click Add endpoint.

6. 6

   Enter a name for the endpoint, such as "Foxy.io", and enter your store's notification endpoint. This looks like https://yourdomain.foxycart.com/ipn.php, where yourdomain.foxycart.com is your Foxy store domain. If you have a custom subdomain, use that instead.

7. 7

   Save the new endpoint.

8. 8

   Back on the INS settings page, under Trigger list, click Edit for the Invoice Status Changed trigger.

9. 9

   On the Edit trigger page, complete the following settings:

   • Under General Settings, set the radio input to Enabled.

   • Under Endpoints, check the checkbox for your Foxy.io endpoint in the Available endpoints panel and click the blue right arrows button in the middle to move it to the Selected endpoints panel.

   • Under Parameters, make sure these six items are checked: vendor_id, invoice_status, vendor_order_id, sale_id, invoice_id and mdf_hash.

10. 10

    Click Save trigger.

Get your credentials

1. 1

   Go back to the main Webhooks & API page of the 2Checkout administration.

2. 2

   In the API section, note the Merchant Code. This is the account number needed for Foxy.

3. 3

   In the Secret word section, note the Instant Notification Service (INS) secret word. You may need to click the eye button to the right of the input to see it.

Enter your credentials in Foxy

1. 1

   Go to the Foxy admin and go to Settings > Payments.

2. 2

   Open or create a payment method set, then click Add payment method + and choose 2Checkout.

3. 3

   Under Live setup, enter your Merchant Code in the Account Number field and your INS secret word in the Secret Word field. This setup only takes effect once Use live credentials is turned on for the payment method set.

4. 4

   Under Test setup, enter the equivalent values from your 2Checkout demo account.

5. 5

   Click Create, or Save if you're editing an existing entry.

Additional configuration to support receipt redirect

By default, 2Checkout shows its own thank you screen when a customer completes their payment. It supports a redirect option, which you enabled in the steps above, but Foxy needs the customer redirected to a dynamic URL that can't be set within the 2Checkout admin. That's what the Header redirect option handles.

The catch is that 2Checkout appears to only allow customers to be redirected to a URL matching the primary URL on the 2Checkout account. If these don't match, the customer won't be redirected back to the Foxy receipt and will see the 2Checkout thank you page instead.

Foxy is still notified through the INS notification that the payment completed, so the customer still gets the Foxy email receipt if that's configured to send. If you want the customer redirected to the Foxy receipt, for analytics or other purposes, you'll need to request that the URL on your 2Checkout account be updated to your Foxy store domain, for example https://yourstore.foxycart.com, or your custom subdomain if you use one.

From 2Checkout:

If the Merchant would like to update the URL on their account, they need to contact our Underwriting team or us at supportplus@2checkout.com and we will make sure the account is updated.

Someone with authorized access to the 2Checkout account will need to make the request.

Testing

Obtaining a test account

Sign up for 2Checkout to get an account.

Test card numbers

If your 2Checkout account is configured in demo mode, you can complete test purchases using these details:

• First name: John

• Last name: Doe

• Card number: 4111 1111 1111 1111

• Card expiry: any future date

• Card CVV: any 3 digit number

Troubleshooting & interpreting response codes

Contact 2Checkout for info.

Important notes and caveats

Possible action: datafeed handling

We don't necessarily know at the time the customer completes the transaction whether it was completed. We rely on a notification from the gateway afterwards to confirm whether it was approved. Transactions are initially marked as pending, and we update them when the gateway confirms the result.

Each time the status changes, a datafeed is sent to your endpoint if configured, with the transaction details and a status node. The status node contains one of three values: pending, approved or rejected. Depending on what your endpoint does, make sure you check for the appropriate status value first.