v12 Finance
The Aurora V12 Finance Integration allows you to take payments at the checkout for orders by way of a finance agreement using the v12 Retail Finance provider.
This article described how to configure this service in Aurora and what it does.
Overview
Once you have configured the V12 Finance service for use in Aurora, when the customer places an order using the Finance option at the checkout, they are redirected to the V12 website in order to complete the Finance process.
At this point, the order is stored in Aurora under the "Pending" status, as configured in the Aurora Back-end > Orders > Statuses section. This order will remain in the "Pending" status without any valid transaction until such a time that you receive notification from V12 that the Finance has been completed and approved, at which point you are required to update the order status accordingly.
It is important to note that if you do not update the order in Aurora manually (whether that's to cancel or approve it), it will remain in the "Pending" status indefinitely, unless "Proactive status updates" are enabled with v12.
Please see the V12 documentation for more details, and how to set this up: https://integration.v12finance.com/developers.html#updated-proactive-status-updates.
The URL to send status updates to is:
https://www.your-domain.com/checkout/v12-finance-feedback
.
Getting started
To get V12 Finance running on your site, you will need to perform all of the following tasks:
- Apply to V12 Retail Finance for your Live and Test accounts.
- Configure Aurora, providing all of the details you have been issued by V12 Retail Finance.
- Set your account settings.
- Configure your Finance Products.
- Add the finance options to the Checkout Templates.
- (Optional) Add the Finance Calculator to the Product Details Template.
Configuring V12 Finance in Aurora
You cannot begin this process before you have created your account with V12 Retail Finance, received all required information and confirmation that your account is active.
Please contact V12 Retail Finance directly to complete this process.
You must configure the V12 Finance system using the Store > Settings > Payment Providers > V12 Finance section in the Aurora Back-end.
To enable the use of this service in Aurora simply enter the requested information (described in more detail below) and tick the "Enabled?" tick-box.
Account details
To make use of the V12 Finance Integration, you are required to provide all of the following information:
- ID
- GUID
You are also prompted for the following fields, though these are only used for running the integration in 'test' mode and are not needed for a Live environment:
- Test ID
- Test GUID
All of this information should be provided to you by V12 Retail Finance. If you do not have these details, please contact V12 Retail Finance for further assistance.
Finance Products
A finance product refers to the 'package' you would like to offer the customer and described the interest charges and price ranges for which it should be used.
These must be configured in your V12 Retail Finance account before you can configure them in Aurora and V12 Retail Finance should provide you with all of the needed information for Aurora to use.
In the Store > Settings > Payment Providers > V12 Finance > Products section, you can configure your list of Finance Products by clicking the "Add Finance Product" button and completing all of the fields requested.
The fields you must complete include all of the following:
- Code - This is a unique code issued to you for each Finance Product by V12 Retail Finance.
- Name - This is the name you would like to give the Finance Product when presenting it to the customer on the website.
- Length - This is the duration in months over which the Finance agreement is spread.
- PID - This is a unique number issued to you for each Finance Product by V12 Retail Finance.
- PGUID - This is a unique code issued to you for each Finance Product by V12 Retail Finance.
- APR - This is the APR charged by each Finance Product.
- Factor - This is the unique code issued to you for each Finance Product by V12 Retail Finance.
- Minimum £ - This is the minimum total order value you require a customer to be making before each Finance Product is presented on the checkout for use.
Testing the V12 Finance Integration
To place this integration in 'test' mode, you can use the "Live?" tick-box in the Store > Settings > Payment Providers > V12 Finance section. When this box is NOT ticked the integrations is automatically placed in test mode and the "Test ID" and "Test GUID" account details used to process your requests.
Please confirm with V12 Retail Finance that your Test account is fully enabled before attempting this or if experiencing any issues processing requests using the 'test' service.
Updated 3 months ago