−Table of Contents
- type:
- gateway
- name:
- Wallee
- support-added:
- 2.0
- auth-net-emulation:
- no
- supports-3dsecure:
- no
- gateway:
- https://en.wallee.com/
Wallee
Subscriptions are not supported with Wallee at this time. If you intend to sell subscriptions with your FoxyCart store, you will need to make use of another payment gateway.
Setting Up Wallee for FoxyCart
Wallee can be enabled for your Foxy store from the “payment” page in the Foxy administration. Enable the “Accept payments using your Wallee account” checkbox on the page. The credentials needed can be accessed by following these steps:
- Log in to the Wallee administration.
- From the left hand menu go to Account > Users > Application Users
- Click on “Create Application User” button and fill in the details.
- Note down the “User ID” and “Authentication Key”. Please note that once you close the User Credential Modal, you won't be able to see the Authentication Key again, So please note it down.
- For Space ID you can either:
- From left hand menu go to Account > Dashboard > Spaces and copy the ID of the desired Space.
- From left hand menu go to Space > Dashboard and you will see the Space ID just beside the User ID after a # symbol. (For more details you can refer to: Wallee docs here)
- From the left hand menu go to Account > Users > Roles
- Enter the name for the Role and select the permissions. Please note that the user should have at least this permission: Root » Account Admin » Space » Payment » Payment Processing » Transaction » Create
- Now from the left hand menu go to Account > Users > Application Users
- Select the Application User you want to use with Foxy
- From the Roles section click on “Manage”
- Add the role created earlier. If you don't want to create a separate role then you can skip the role creation steps from step 2-3 and simply choose either “Account Admin” or “Space Admin” role here.
Add webhook URL and webhook listener
- Log in to the Wallee administration
- From the left menu go to Space > Settings > Main > Webhook URL > Create Webhook URL
- Enter the Name and the URL. In the “URL”, you need to enter your store's IPN URL to be
https://YOUR-FOXYCART-STORE-DOMAIN/ipn.php
- changing it to match your own FoxyCart store domain. For example, if your FoxyCart store domain wasexample.foxycart.com
, you would set the URL to behttps://example.foxycart.com/ipn.php
. If it was a custom subdomain likesecure.example.com
the URL would behttps://secure.example.com/ipn.php
. Click create. - Go back to Settings > Main > Webhook Listeners > Create Webhook Listener
- Select Entity as “Transaction”. Continue.
- Add Name, select the URL we added earlier in step 2-3. Under “Entity States” select completed, fulfill, failed, voided and decline
- Important: Please Enable Payload Signature And State option. This is important from security perspective. If you don't enable it, foxy endpoint won't be able to process your payment notification and the status of your transaction might not reflect correctly in Foxy admin.
- Click create.
Add Payment Processor Configuration
- Log in to the Wallee administration
- From the left hand menu go to Space > Settings > Processors > Configure Processor
- Select the Processor, add the Name for your processor and select the Operation Mode (Production/Test)
- Click “Create” button and on the next screen select the Connectors you want to bind to this processor.
- Save
Testing
Obtaining a Test Account
A test account can be created at https://app-wallee.com Contact wallee for info. Know more? Feel free to edit this page with info.
Test Card Numbers
A collection of test cards can be seen on the Wallee documentation here.
Troubleshooting & Interpreting Response Codes
Contact wallee for info. Know more? Feel free to edit this page with info.
Important Notes and Caveats
Please make sure you follow all the steps described in setup part
User Notes and Experiences
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.