2Checkout

Setting Up 2Checkout for FoxyCart

1. 1

   In your 2Checkout administration, proceed to the “Webhooks & API” section found under “Integrations”

2. 2

   Within the “Instant Notification System (INS)” section, check the checkbox labelled “Enable INS” and click “Update”. Note that there are also settings for the “IPN” in 2Checkout, which Foxy doesn't utilise, just the “INS”.

3. 3

   Within the “Redirect URL” section, check the checkbox for “Enable return after sale”, and set the “Return method” dropdown to “Header redirect”. Leave the “Approved URL” text input blank. Click “Update”.

4. 4

   At the top of the “Webooks & API” section, select the “INS settings” tab (again, note “INS” and not “IPN”. If you don't see it, ensure you enabled it as detailed in the first section, and that you're looking at the tabs towards the top of the page)

5. 5

   Click the “Add endpoint” button

6. 6

   On the Add endpoint page, enter a name for the endpoint (like “Foxy.io”), and enter your store's notification endpoint. This will look like https://yourdomain.foxycart.com/ipn.php, where yourdomain.foxycart.com is your Foxy store domain. If you have a custom subdomain, you will use that instead of the foxycart.com subdomain.

7. 7

   Save the new endpoint

8. 8

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

9. 9

   On the Edit trigger page, complete the following settings

   1. Under “General Settings”, set the radio input to “Enabled”

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

   3. Under “Parameters” ensure these 6 items are checked:

      1. vendor_id

      2. invoice_status

      3. vendor_order_id

      4. sale_id

      5. invoice_id

      6. mdf_hash

10. 10

    Click “Save trigger”

11. 11

    Go back to the main “Webooks & API” page of the 2Checkout administration

    1. In the “API” section, note the “Merchant Code”, this is the “account number” needed for the Foxy payments configuration

    2. In the “Secret word” section, note the “Instant Notification Service (INS) secret word”, this is the “secret word” needed for the Foxy payments configuration (you may need to click the eye button to the right of the text input to see all in 2Checkout).

12. 12

    Copy these two settings into the respective fields in your Foxy store administration, on the “payments” page after enabling “Accept payments using your 2Checkout account”.

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 admin which is completed through the “Header redirect” option.

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

Foxy will still be notified through the INS notification that the payment completed, so the customer will get the Foxy email receipt if that's configured to send. If you would like the customer to be redirected to the Foxy receipt (for analytics or other purposes), you will need to request that the URL for your 2Checkout account be updated to your Foxy store domain, for example https://yourstore.foxycart.com (or your custom subdomain if you're using that).

Here is a quote 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.

Note that someone with authorized access to the 2Checkout account will want to make the request.

Testing

Obtaining A Test Account

Signup for 2Checkout here.

Test Card Numbers

If your 2Checkout account is configured in demo mode, you can complete test purchases by using the following details for your order:

• 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

At the time of the customer completing the transaction - we don't necessarily know whether the transaction was completed yet or not. We instead rely on a notification from the gateway after the checkout has been completed to confirm whether the transaction was approved or not. To handle this, transactions are initially marked as pending, and when we get a confirmation from the gateway on the result of the transaction, we update it accordingly. Each time the status changes, a datafeed will be sent to your endpoint if configured with the transaction details and the status node will be present.

The status node can contain one of three different values: pending, approved or rejected. Depending on the types of actions you're needing to perform at your datafeed endpoint, you need to make sure the appropriate status value is present first.