Guides

Farmlands Portal Guide

Farmlands Co-operative (Farmlands) have partnered with Centrapay Payment Gateway (Centrapay) to deliver a secure web portal for Card Partners to gain an instant authorisation on a Farmlands Card when presented as payment for a sale. This option does not require integration with a Point of Sale (POS) system.

Key Benefits:

  • Enables Industry standard, card validation checks prior to agreeing to accept a Farmlands Card for payment of goods or services.
  • Reduces exposure to fraud, especially for high-value products/ or when a Farmlands Card number is provided as payment for a phone or online order (Card not present transaction)
  • Mitigates issues with unpaid invoices due to insufficient or incorrect Cardholder information provided to Farmlands

Getting Started

Business Information

The initial setup of your Business and all Branches (referred to as Merchants) will be managed by Farmlands. Farmlands will provide Centrapay with the details of a primary Account Owner for the business who will be loaded by Centrapay. Once setup this account owner will be able login and maintain the other members (users) who have or need access to the Account (see Members).

Registration

Once the Business and Merchants are set up in the Centrapay Portal, users will receive an email from Farmlands inviting them to register for the portal. Users must use the email address provided in the initial setup process to register.

During registration a Verification Code will be sent to the email account by Centrapay, this code must be entered into the Portal when prompted to confirm your identity. The verification code is active for 15 minutes from when it is received.

If you do not receive a Verification Code, please check your Spam folder. If the code has expired, repeat the registration process to request a new code.

Log In

The Centrapay Business Portal will store your authenticated session for up to 60 days. During this time, it is not necessary to re-authenticate simply enter your email address to log in. After 60 days, you will be prompted to re-authenticate by entering a Verification Code sent to your registered email address.

In some cases, a user may be requested to select a business location as the default.  This ensures all authorises are loaded against that location and can assist when searching for authorisation history.

We recommend bookmarking the Centrapay Business Portal for easy access.

Dashboard

The Dashboard is an overview of Centrapay Business Account and will be your main screen for generating an authorisation or releasing a previous Farmlands Authorisation.

The dashboard of the centrapay business portal

Farmlands Authorisations

The Centrapay Business Portal provides a real-time authorisation of a Farmlands Card when presented as payment for the purchase of goods or services. It validates that the Card is active and there is a sufficient available balance to process the transaction.

Authorisation Responses

TypeDescription
Authorisation ApprovedFunds have now been placed on hold onto the customer account, pending the receipt of the Card Partner’s invoice within the agreed period.
PendingCard Partner creates the request, but the authorisation is not yet complete. This authorisation is not approved.
Check IDThis response may occur for a high-value sale. This means the transaction is pending authorisation until the Card Partner confirms they have authenticated the customer’s photo ID against the name on the Farmlands Card.
DeclinedThe authorisation is declined due to an invalid card number, a credit limit exceeded, or Card Partner is unable to verify a high-value transaction. Refer to Farmlands Contact Centre 0800 200 600
ReleaseThe funds “on hold” are cancelled by Card Partner. This may occur when a Card Partner is unable to fulfil an order. (This is not used for a refund).

Create a Farmlands Authorisation

  1. Select Create Authorisation Request from the main dashboard.

    Create a Farmlands authorisation request on the Centrapay business portal

  2. Enter the total amount of the sale (including GST)

    Make sure the correct merchant is selected

    Enter payment amount on the Centrapay business portal

  3. Scan the barcode on the rear of the Farmlands Card by using the camera function or scanner (if available). Alternatively, manually enter the 9-digit Card number located on the front of the Card (bottom left-hand corner or below the barcode on the rear of the Card).

    The 9-digit Card number displayed on the Card must be entered, not the 16-digit card number or 9-digit account number.

    Scan and Enter Farmlands barcode on the Centrapay business portal

  4. Cardholder Not Present - Tick this box if you are seeking an authorisation for a sale where the Cardholder is not physically present e.g. a phone or online order when a Card number has been quoted.

    Select card holder not present on the Centrapay business portal

  5. Add the Customer Reference (Optional) to relate to the customer invoice.

    Enter the Customer's Farmlands Reference

  6. Click Create

  7. Check ID - This response may be given for high-value or high-risk transactions. The user is required to request request the Cardholder to provide photo ID to check against the Cardholder’s name. The transaction remains in a “pending” state until the user confirms they have authenticated the Card.

    Check photo ID and accept condition on the Centrapay business portal

  8. Approved - Response received.

    Payment Authorization approved on the Centrapay business portal

  9. Copy Short Code - Once approved this will bring up the Authorisation Approved screen, showing the “Short Code”. The Short code must be copied into the PO field of your invoice and then sent to Farmlands.

  10. Click Close - This will redirect you to the Payment screen showing the authorisation history.

    Summary of payments on the Centrapay business portal

Invoicing & Settlement

Once an approved authorisation has been provided, a full GST invoice must be submitted to Farmlands at vendor.invoices@farmlands.co.nz. The Short Code shown on the Approval screen must be copied and clearly displayed in the PO field of the invoice or where previously confirmed with the Farmlands Team. The Farmlands 9-digit Card number can be provided in addition to the Short Code in another field. Settlement will be completed as per agreed payment terms.

Payment Authorization approved on the Centrapay business portal

Farmlands encourages invoices to be submitted daily rather than at the end of the month. This allows Farmlands to apply the purchase to the customer’s account in a timely manner.

Instore Transactions
A physical Farmlands Card must be presented to complete an in-store sale. It is recommended Card Partners do not accept photographs or representation of the Card on an app e.g.Stocard. In doing so, this is considered a Card Not Present transaction.


Phone Order & Online Transactions
Farmlands Card details can be accepted remotely for a phone or online website order. Cardholders must have provided authorisation to charge a Card on a regular, ongoing basis. This type of transaction must be flagged as Cardholder Not Present and Card Partner acknowledges the increased risk of processing transactions where no Card is presented.


Card Partner Terms and Conditions
Payment is made on the basis that all Card Partner terms and conditions are met.

Releasing Funds

The Authorised funds will be held against the Cardholder account for 31 days or until the invoice is received. If the order is cancelled before the invoice is submitted to Farmlands the Authorisation should be released to remove the hold on Cardholder funds.

Once you have released the funds, this step cannot be reversed.


If an invoice has been sent to Farmlands a credit (refund) must be submitted to Farmlands to reverse the transaction.

Release Hold on Customer Funds

  1. Navigate to the Payments page

  2. Select the authorisation from the list in the Payments History

  3. Click “Release Funds”

    Release funds on Centrapay business portal

  4. Click “Approve Release” This step cannot be undone after clicking Approve Release.

    Approve release of funds on the Centrapay business portal

Authorisation History

The Payments page provides a list of transactions that were previously authorised. You can search by using the Authorisation Short Code as the reference. Further search functionality will be available at a later date.

From this screen, you can also select an authorisation and action a “release,” cancelling the “hold” placed on the Cardholder funds

Summary of authorisations on the Centrapay business portal

Setting a Default Merchant

Select your Default Merchant (First-time user) - The default merchant is the branch or outlet that the user normally works from, and which the transaction will be associated with.

  1. Click on the Merchant drop-down menu

Select a merchant during payment on the Centrapay business portal

  1. Click Edit My Default Merchant

Edit the default merchant for payment on the Centrapay business portal

  1. Select a merchant from the merchants listed.

Select default merchant on the Centrapay business portal

  1. Click Set as Default

Manage My Centrapay Business Account

The Account Owner has access to additional options to manage their Centrapay Business Account, including adding an removing users who have access to complete authorisations on their account.

If the the Account Owner want their business to be able to accept different Centrapay Payment Methods as well as Farmlands Card these can be added and managed here.

Merchants

This area relates to the management of new and existing Branches/Locations used for Centrapay’s other payment types e.g tokens (i.e not Farmlands). Additional merchants added through the Merchants area will not be able to accept Farmlands Card until they are setup by Farmlands.

If you are needing to add a new branch/location, please contact your Card Portfolio Manager or card.specialist@farmlands.co.nz as Farmlands will need to complete the setup of the branch/location within our system prior to this being enabled in the Portal.

Centrapay business portal merchants page

Bank Accounts

This function is only available to businesses who wish to use other Centrapay supported payment methods other than Farmlands Cards. (e.g. NZD).

Farmlands Card transactions are settled through the existing settlement methods. If you need to update you settlement details please contact your Card Portfolio Manager or card.specialist@farmlands.co.nz.

Centrapay business portal bank accounts page

Members

On the Members page you can manage the members connected to the Centrapay Business Account. An Account Owner can see the list of members and pending invitations and easily add or remove members.

Centrapay business portal members page

Adding members

  1. An Account owner can select the Members page in the left sidebar menu. Centrapay business portal add members screen

  2. The Account owner can click Add people.

  3. Enter the email address of the new member. Enter Member's email address

  4. Select the member’s role (account owner or cashier). Select Member's role

  5. Press Send Invitation.

  6. The member that was added will receive an email that will allow them to accept the invitation and join the business account. The invitation will be in pending state until the member accepts the invitation. Invitation sent modal

  7. User accepts invitation and is added to the list of members. User is added to Members list

Revoke Invitation

  1. Account owner can select the Members page in the left sidebar menu. Select the Members page

  2. Find the pending invite they wish to revoke.

  3. Click on the three dots beside the pending invite. Click on the three dots besides the invitation

  4. Press Revoke Invitation.

  5. The invitation is now revoked and will no longer show inside the pending invitation list. Invitation revoked modal

Removing members

  1. Account owner can select the Members page in the left sidebar menu. Select the Members page

  2. Find the member they wish to remove.

  3. Click on the three dots beside the member. Click on the three dots besides the member

  4. Press Remove Member.

  5. Member is removed and will not longer show in the members list. Member removed modal

Settings

On the Settings page, you can change your business information. Please note this does not flow through to Farmlands. If you have a change of ownership, please contact Farmlands.

Centrapay business portal settings page

FAQs

Support

The Support button opens up a form that will allow you to send a support request directly to Centrapay if you have any issues regarding the Centrapay Business Portal.

Alternatively email support@centrapay.com for issues regarding the portal. Please refer Cardholders to Farmlands if they have a query on a declined transaction, 0800 200 600 or ask@farmlands.co.nz.