From daac408d23076bb9d1df291cd329b635bbfc3dde Mon Sep 17 00:00:00 2001
From: Tom Blake <46909693+tom-blake@users.noreply.github.com>
Date: Fri, 6 Dec 2024 12:02:22 +1300
Subject: [PATCH] Convert remaining guides to markdoc (#1133)
Convert remaining guides to markdoc and remove the AccordionListWrapper
component in favour of vanilla markdown syntax.
Test plan:
- Confirm converted guides are rendered
---
.../links.integration.test.js.snap | 8 +-
src/components/AccordionListWrapper.astro | 5 -
src/content/guides/compatible-devices.mdoc | 74 ++++++++
src/content/guides/compatible-devices.mdx | 147 ----------------
.../farmlands-card-partner-support.mdoc | 83 +++++++++
.../guides/farmlands-card-partner-support.mdx | 101 -----------
...lands-portal.mdx => farmlands-portal.mdoc} | 160 +++++++-----------
7 files changed, 227 insertions(+), 351 deletions(-)
delete mode 100644 src/components/AccordionListWrapper.astro
create mode 100644 src/content/guides/compatible-devices.mdoc
delete mode 100644 src/content/guides/compatible-devices.mdx
create mode 100644 src/content/guides/farmlands-card-partner-support.mdoc
delete mode 100644 src/content/guides/farmlands-card-partner-support.mdx
rename src/content/guides/{farmlands-portal.mdx => farmlands-portal.mdoc} (71%)
diff --git a/src/__tests__/__snapshots__/links.integration.test.js.snap b/src/__tests__/__snapshots__/links.integration.test.js.snap
index 004446aea..eb62f4e96 100644
--- a/src/__tests__/__snapshots__/links.integration.test.js.snap
+++ b/src/__tests__/__snapshots__/links.integration.test.js.snap
@@ -311,8 +311,14 @@ exports[`the build should not break any links 1`] = `
"/fiat/bank-authorities",
"/fiat/funds-transfers",
"/guides/compatible-devices",
- "/guides/compatible-devices#integrated-providers",
+ "/guides/compatible-devices#invenco",
"/guides/compatible-devices#on-this-page-title",
+ "/guides/compatible-devices#salespoint",
+ "/guides/compatible-devices#sektor",
+ "/guides/compatible-devices#skyzer",
+ "/guides/compatible-devices#smartpay",
+ "/guides/compatible-devices#verifone",
+ "/guides/compatible-devices#windcave",
"/guides/creating-digital-tokens",
"/guides/creating-digital-tokens#implementation",
"/guides/creating-digital-tokens#on-this-page-title",
diff --git a/src/components/AccordionListWrapper.astro b/src/components/AccordionListWrapper.astro
deleted file mode 100644
index 60e7d0667..000000000
--- a/src/components/AccordionListWrapper.astro
+++ /dev/null
@@ -1,5 +0,0 @@
-
diff --git a/src/content/guides/compatible-devices.mdoc b/src/content/guides/compatible-devices.mdoc
new file mode 100644
index 000000000..b1a9cef78
--- /dev/null
+++ b/src/content/guides/compatible-devices.mdoc
@@ -0,0 +1,74 @@
+---
+title: Compatible Devices
+description: A comprehensive list of all of the devices that Centrapay supports.
+nav:
+ path: Reference/Merchant Integrations
+ order: 1
+---
+The Centrapay service is supported on a range of payment and point of sale devices listed below. If the device model is not in this list, it may not be supported. If you would like to discuss a new integration or support of Centrapay on a new device, please contact Centrapay at support@centrapay.com
+
+## Invenco
+- G6-300
+- G6-400
+- G6-500
+
+## SalesPoint
+- Epay Convenience POS (ECP SalesPoint)
+
+## Sektor
+- Pax 6650
+- Pax A50
+- Pax A77
+- Pax A901s
+- Pax A920 Max
+- Pax A920 Pro
+- Pax A3700 Tablet
+- Pax Aries 6
+- Pax E600 Mini
+- Pax IM30
+- Pax XA35
+
+## Skyzer
+- Desk 5000
+- Move 5000
+
+## Smartpay
+- Pax S800
+- S900
+- Pax S920
+
+## Verifone
+- Android T650C
+- Android T650M
+- Android T650P
+- CM5 Flat
+- M400
+- M424
+- M440
+- P400
+- P630
+- V200T
+- V205C
+- V210
+- V240M
+- V400
+- V400C
+- VX675
+- VX680
+- VX690
+- VX820
+- VX820 Duet
+- UX700 (Unattended Android)
+
+## Windcave
+- CHU200M
+- CHU200MP
+- CHU200T
+- CHU200TL
+- CHU200TP
+- IPP350
+- IWL25C
+- IWL252
+- LANE3000
+- MOVE5000
+- MTM300
diff --git a/src/content/guides/compatible-devices.mdx b/src/content/guides/compatible-devices.mdx
deleted file mode 100644
index 2ff21f14f..000000000
--- a/src/content/guides/compatible-devices.mdx
+++ /dev/null
@@ -1,147 +0,0 @@
----
-title: Compatible Devices
-description: A comprehensive list of all of the devices that Centrapay supports.
-nav:
- path: Reference/Merchant Integrations
- order: 1
----
-import Disclosure from '../../components/Disclosure.vue';
-import AccordionListWrapper from '../../components/AccordionListWrapper.astro';
-
-The Centrapay service is supported on a range of payment and point of sale devices listed below. If the device model is not in this list, it may not be supported. If you would like to discuss a new integration or support of Centrapay on a new device, please contact Centrapay at support@centrapay.com
-
-## Integrated Providers
-
-
-
-
- G6-300
-
- G6-400
-
- G6-500
-
-
-
-
-
- Epay Convenience POS (ECP SalesPoint)
-
-
-
-
-
- Pax 6650
-
- Pax A50
-
- Pax A77
-
- Pax A901s
-
- Pax A920 Max
-
- Pax A920 Pro
-
- Pax A3700 Tablet
-
- Pax Aries 6
-
- Pax E600 Mini
-
- Pax IM30
-
- Pax XA35
-
-
-
-
-
- Desk 5000
-
- Move 5000
-
-
-
-
-
- Pax S800
-
- S900
-
- Pax S920
-
-
-
-
-
- Android T650C
-
- Android T650M
-
- Android T650P
-
- CM5 Flat
-
- M400
-
- M424
-
- M440
-
- P400
-
- P630
-
- V200T
-
- V205C
-
- V210
-
- V240M
-
- V400
-
- V400C
-
- VX675
-
- VX680
-
- VX690
-
- VX820
-
- VX820 Duet
-
- UX700 (Unattended Android)
-
-
-
-
-
- CHU200M
-
- CHU200MP
-
- CHU200T
-
- CHU200TL
-
- CHU200TP
-
- IPP350
-
- IWL25C
-
- IWL252
-
- LANE3000
-
- MOVE5000
-
- MTM300
-
-
-
diff --git a/src/content/guides/farmlands-card-partner-support.mdoc b/src/content/guides/farmlands-card-partner-support.mdoc
new file mode 100644
index 000000000..76eacbb45
--- /dev/null
+++ b/src/content/guides/farmlands-card-partner-support.mdoc
@@ -0,0 +1,83 @@
+---
+title: Farmlands Card Partner Support Guide
+description: How to for Farmlands Card Partners and Card Holders to request support from the relevant company and teams to get the help they need.
+nav:
+ path: Connections/Farmlands
+ title: Support Guide
+ order: 4
+---
+If you are a Farmlands Card Partner needing extra support this is the guide for you. Here you will find who you need to reach out to and how you can get in touch with them.
+
+## Support for Portal Users
+
+1. If you require assistance with Portal functionality, contact Centrapay at support@centrapay.com or Farmlands at card.specialist@farmlands.co.nz
+You can also use the Support window inside the Portal.
+2. 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.
+
+### Troubleshooting
+
+**What is the address for the portal?**
+
+https://app.centrapay.com/business
+
+**I am getting an invalid barcode message in the portal**
+
+Double check you are entering the correct length barcode on the card. If you are using the scan feature, try to enter it manually instead.
+
+**What if the barcode will not scan or is obscured?**
+
+The 9-digit Card number can be entered manually. This is printed on the back below the barcode and on the front of the card under the Cardholder's name. If neither is visible, please request another method of payment. Advise the Cardholder to contact Farmlands on 0800 200 600 to request a new Card.
+
+**What should I do if the Authorisation is declined?**
+
+Request an alternative form of payment from your customer. Refer the Cardholder to Farmlands on 0800 200 600 for further information.
+
+**How do I check if a transaction was authorised or where can I see the transaction history?**
+
+Go to the Payments page on the Centrapay Business Portal, select the transaction related to the Farmlands Authorisation and check that the status is Authorised.
+
+**Is there a portal guide that covers additional Trouble Shooting FAQs and that can help with training?**
+
+Yes. If you go to the portal and click on the dashboard there is a guides section or go to the [Farmlands Portal Guide](/guides/farmlands-portal)
+
+## Support for POS Integrators
+
+1. If you require assistance with POS integration functionality contact Centrapay at support@centrapay.com or Farmlands at card.specialist@farmlands.co.nz
+2. If you require assistance with the POS integration contact your POS provider.
+
+## SLA Support Level
+
+### P1 - Severe Business Disruption
+
+Centrapay Platform is unable to process transactions initiated by Card Partners
+
+**Target Response:** < 1 hour
+
+**Target Resolution:** 3 hours
+
+### P2 - Major Business Disruption
+
+Centrapay Platform unable to:
+
+- provide transaction data to the Customer
+- ingest Customer card updates (full or delta)
+
+**Target Response:** 4 hour
+
+**Target Resolution:** 16 hours
+
+### P3 - Minor Business Disruption
+
+Centrapay Platform is operational but suffering performance degradation
+
+**Target Response:** 8 hours
+
+**Target Resolution:** 32 hours
+
+### P4 - Adhoc requests as requested by Farmlands
+
+Adhoc requests as requested by Farmlands
+
+**Target Response:** 12 hours
+
+**Target Resolution:** N/A
diff --git a/src/content/guides/farmlands-card-partner-support.mdx b/src/content/guides/farmlands-card-partner-support.mdx
deleted file mode 100644
index f5740cd4e..000000000
--- a/src/content/guides/farmlands-card-partner-support.mdx
+++ /dev/null
@@ -1,101 +0,0 @@
----
-title: Farmlands Card Partner Support Guide
-description: How to for Farmlands Card Partners and Card Holders to request support from the relevant company and teams to get the help they need.
-nav:
- path: Connections/Farmlands
- title: Support Guide
- order: 4
----
-
-import Disclosure from '../../components/Disclosure.vue';
-import AccordionListWrapper from '../../components/AccordionListWrapper.astro';
-
-If you are a Farmlands Card Partner needing extra support this is the guide for you. Here you will find who you need to reach out to and how you can get in touch with them.
-
-## Support for Portal Users
-
-1. If you require assistance with Portal functionality, contact Centrapay at support@centrapay.com or Farmlands at card.specialist@farmlands.co.nz
-You can also use the Support window inside the Portal.
-2. 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.
-
-### Trouble Shooting
-
-
-
-
- https://app.centrapay.com/business
-
-
-
-
-
- Double check you are entering the correct length barcode on the card. If you are using the scan feature, try to enter it manually instead.
-
-
-
-
-
- The 9-digit Card number can be entered manually. This is printed on the back below the barcode and on the front of the card under the Cardholder's name. If neither is visible, please request another method of payment. Advise the Cardholder to contact Farmlands on 0800 200 600 to request a new Card.
-
-
-
-
-
- Request an alternative form of payment from your customer. Refer the Cardholder to Farmlands on 0800 200 600 for further information.
-
-
-
-
-
- Go to the Payments page on the Centrapay Business Portal, select the transaction related to the Farmlands Authorisation and check that the status is Authorised.
-
-
-
-
-
- Yes. If you go to the portal and click on the dashboard there is a guides section or go to the [Farmlands Portal Guide](/guides/farmlands-portal)
-
-
-
-
-## Support for POS Integrators
-
-1. If you require assistance with POS integration functionality contact Centrapay at support@centrapay.com or Farmlands at card.specialist@farmlands.co.nz
-2. If you require assistance with the POS integration contact your POS provider.
-
-## SLA Support Level
-
-### P1 - Severe Business Disruption
-
-Centrapay Platform is unable to process transactions initiated by Card Partners
-
-**Target Response:** < 1 hour
-
-**Target Resolution:** 3 hours
-
-### P2 - Major Business Disruption
-
-Centrapay Platform unable to:
-
-- provide transaction data to the Customer
-- ingest Customer card updates (full or delta)
-
-**Target Response:** 4 hour
-
-**Target Resolution:** 16 hours
-
-### P3 - Minor Business Disruption
-
-Centrapay Platform is operational but suffering performance degradation
-
-**Target Response:** 8 hours
-
-**Target Resolution:** 32 hours
-
-### P4 - Adhoc requests as requested by Farmlands
-
-Adhoc requests as requested by Farmlands
-
-**Target Response:** 12 hours
-
-**Target Resolution:** N/A
diff --git a/src/content/guides/farmlands-portal.mdx b/src/content/guides/farmlands-portal.mdoc
similarity index 71%
rename from src/content/guides/farmlands-portal.mdx
rename to src/content/guides/farmlands-portal.mdoc
index 7ebee63ba..affbc98d9 100644
--- a/src/content/guides/farmlands-portal.mdx
+++ b/src/content/guides/farmlands-portal.mdoc
@@ -7,10 +7,6 @@ nav:
order: 3
img: /farmlands-portal-guide-cover.jpg
---
-
-import Disclosure from '../../components/Disclosure.vue';
-import AccordionListWrapper from '../../components/AccordionListWrapper.astro';
-
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:**
@@ -110,23 +106,18 @@ Once an approved authorisation has been provided, a full GST invoice must be sub
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.
-
+> 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.
-
+> 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.
+> 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
@@ -252,91 +243,66 @@ On the Settings page, you can change your business information. Please note this
![Centrapay business portal settings page](/centrapay-portal-settings.png)
-## FAQs
-
-
-
-
- Raise a credit note as normal and insert the original authorisation short code on the invoice. This will enable us to identify the original invoice and customer account details.
-
-
-
-
-
- Raise a credit note as normal and insert the original authorisation short code on the invoice. This will enable us to identify the original invoice and customer account details.
-
-
-
-
-
- If the entire order has been cancelled, release the hold on the customer’s funds via the Portal. There is no requirement to send an invoice to Farmlands.
-
-
-
-
-
- If the revised sale amount is:
- - less than the original authorisation amount, submit the amended invoice with the original authorisation short code.
- - greater than the original authorisation sales amount, release the hold on the customer’s funds via the Portal. Once completed, generate a new authorisation request for the revised sales amount.
-
-
-
-
-
- The value of the authorisation will be held on the customer’s Card for up to 31 days. It is important Invoices, with a valid authorisation short code, are submitted to Farmlands as soon as possible so these can be matched against the funds held.\
- Invoices received after 31 days and up to 3 months will be processed in good faith however, if the associated Farmlands Account has been closed, you will be advised to contact the customer for another form of payment.\
- If you are concerned, **re-authorise the transaction especially prior to fulfilling a back order if it is over 31 days since originally authorised.**
-
-
-
-
-
- The Card number being entered is either not a valid number or the Card being presented is no longer active on the Farmlands system. Check the correct Card number has been entered or request another method of payment.
-
-
-
-
-
- User management and access is at the discretion of the Card Partner.
-
-
-
-
-
- Go into the Portal, find the original authorisation by searching for the Short Code. Click the authorisation and then “Release Funds”.
- If you have sent the original invoice to Farmlands, you must still create a credit note and send it to Farmlands. Use the same short code as the original Invoice.
-
-
-
-
-
- All sales where a Farmlands Card has been provided as payment require an authorisation prior to submitting an invoice to Farmlands.\
- If you hold your customer’s Farmlands’ Card number on file and have their permission to charge this on a recurring basis, please select the 'Cardholder Not Present' option at the time of sale.
-
-
-
-
-
- The 9-digit Card number can be entered manually. This is printed on the back below the barcode and on the front of the Card under the Cardholder's name.\
- If neither is visible, please request another method of payment. Advise the Cardholder to contact Farmlands to request a new Card.
-
-
-
-
-
- No, unfortunately you must only accept the Card if the true owner of the Card is making the purchase.
-
-
-
-
-
- No, the Card Partner should contact the Farmlands Card Team to set up a new merchant/location in the first instance.
-
-
-
-
-## **Support**
+## 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.
+
+## FAQs
+
+**What do we do if a customer returns one or more items, and the invoice has already been sent to Farmlands?**
+
+Raise a credit note as normal and insert the original authorisation short code on the invoice. This will enable us to identify the original invoice and customer account details.
+
+**What do we do if the customer cancels their order after we have sent the invoice to Farmlands?**
+
+Raise a credit note as normal and insert the original authorisation short code on the invoice. This will enable us to identify the original invoice and customer account details.
+
+**What do we do if the customer cancels their order before we have sent the invoice to Farmlands?**
+
+If the entire order has been cancelled, release the hold on the customer’s funds via the Portal. There is no requirement to send an invoice to Farmlands.
+
+**What do we do if we need to amend the value of the order prior to sending the invoice to Farmlands?**
+
+If the revised sale amount is:
+- less than the original authorisation amount, submit the amended invoice with the original authorisation short code.
+- greater than the original authorisation sales amount, release the hold on the customer’s funds via the Portal. Once completed, generate a new authorisation request for the revised sales amount.
+
+**How long are funds held for on a Customer’s Card?**
+
+The value of the authorisation will be held on the customer’s Card for up to 31 days. It is important Invoices, with a valid authorisation short code, are submitted to Farmlands as soon as possible so these can be matched against the funds held.\
+Invoices received after 31 days and up to 3 months will be processed in good faith however, if the associated Farmlands Account has been closed, you will be advised to contact the customer for another form of payment.\
+If you are concerned, **re-authorise the transaction especially prior to fulfilling a back order if it is over 31 days since originally authorised.**
+
+**We received a message on the Portal stating the “Barcode is invalid.” What does this mean?**
+
+The Card number being entered is either not a valid number or the Card being presented is no longer active on the Farmlands system. Check the correct Card number has been entered or request another method of payment.
+
+**How do I manage who has access to the Authorisation Portal?**
+
+User management and access is at the discretion of the Card Partner.
+
+**How do I release funds held on a customer’s Card?**
+
+Go into the Portal, find the original authorisation by searching for the Short Code. Click the authorisation and then “Release Funds”.
+If you have sent the original invoice to Farmlands, you must still create a credit note and send it to Farmlands. Use the same short code as the original Invoice.
+
+**We have a regular customer. Do we need to obtain an authorisation?**
+
+All sales where a Farmlands Card has been provided as payment require an authorisation prior to submitting an invoice to Farmlands.\
+If you hold your customer’s Farmlands’ Card number on file and have their permission to charge this on a recurring basis, please select the 'Cardholder Not Present' option at the time of sale.
+
+**What if the barcode will not scan or is obscured?**
+
+The 9-digit Card number can be entered manually. This is printed on the back below the barcode and on the front of the Card under the Cardholder's name.\
+If neither is visible, please request another method of payment. Advise the Cardholder to contact Farmlands to request a new Card.
+
+**The authorisation request has prompted us to “Check ID.” The customer is not the actual Cardholder but one of the workers of the Cardholder. Can I accept the Card?**
+
+No, unfortunately you must only accept the Card if the true owner of the Card is making the purchase.
+
+**Can the Account-Owner add a new merchant/location to the Portal?**
+
+No, the Card Partner should contact the Farmlands Card Team to set up a new merchant/location in the first instance.
+