iM Release 23.05.05y will provide you the ability to integrate to Pineapple Payments.

The first thing you will need to set up are new Tenders for each Credit Card Merchant (AMEX/VISA/MASTERCARD/DISCOVER) that tie to Pineapple Payments

A Tender must be created for each credit, debit, that will be using Pineapple Payments. 

Older tenders that were associated with a previous processor can be updated, however it is better to create new ones specifically for Pineapple.  

If an older tender is being updated, the sales taken using the older interface cannot be voided, and might have a problem recreating the sale when reprinting an invoice. 

Since duplicate tender codes cannot exist, when replacing old tenders with new, it is best to update the code used on the old tender to identify is as old or from previous processor

This also allows you to use the same common names for the new Pineapple Payments tenders.

Every card type accepted by Pineapple Payments, VISA, Master Card, AMEX, Discover, must be defined within iMRCHNT. 

If a Pineapple Payments tender is not set up for a card that is allowed in Pineapple Payments, POS will give the user an error and void the accepted transaction.

You will initially be set up with Pineapple Payments to accept the 4 major American card companies (VISA, Master Card, AMEX, Discover). If you would like to be able to accept more you will need to speak with

Some debit cards will report back the card type VISA, Master Card, etc. A separate iMRCHNT debit tender can be created for each card type which allows the debit card types to be broken out within POS. 

If a specific card type debit card tender is not present in iMerchant, the generic “Debit” type will be used. You will do the same for a generic credit card

To create new Credit Card Tenders go to: Tools > Parameters > Tenders > Click on New Button

Select New Tender Type = Credit Card and click on the Next Button

In this example we will set up a new VISA that ties to Pineapple

Fill in the Description and Code as you'd like

Within the General Tab the Summary Description is what will appear on a receit

Fill out the Accounting Code as you'd like and Currency code = USA if you're in the United States, there are other currency options if you are not operating in the United States.

Within Misc. check allow as Return Credit.

Balance Tab is all grayed out.

Requirements Tab will allow you to set some limits per card type if you'd like but not really recommended

Validate Tab remains blank

Credit Card Tab

Card Type = Visa

- this dropdown has a number of Card Type options. Your Pineapple Integration will be set up to accept AMEX, VISA, DISCOVER, MASTERCARD.

- You will want to create a tender for each of these four, then a fifth tender that is generic credit card and a sixth that is generic debit card

Interface = Pineapple Device

Save and Close the Tender and repeat for the other Card Types.

You'll now have 6 Tenders that are tied directly to Pineapple Payments devices.

When you receive your new Pin Pads from Pineapple please contact iMRCHNT to that we can get your username/pw credentials from CardPointe.

You will need this information in order to set up and integrate your Pin Pads to iMRCHNT.

Once you have your username/pw from us

Go To: Tools > Parameters > Pineapple Device

Here we have an Ingenico Lane 3000 and a Clover Mini Set Up.

For Ingenico Units this is the information that needs to be filled out:

Required Ingenico Fields:

1) Merchant ID (MID) = Each of your accounts will be given a MID

2) Authorization Key = W0U274hdo8icNd28KAi7sKi9K0T4XFtl+t5Lk5Vu+LE=

3) Username = iMRCHNT has to acquire from CardPointe

4) Password = iMRCHNT has to acquire from CardPointe

5) HSN = S/N found on the bottom of the Ingenico unit - if uncertain iMRCHNT can assist

6) CardPoint URL = boltgw

7) Bolt URL = bolt

8) Clover URL = bolt

Within the Settings common to all devices: 

We suggest that you check Confirm Sale Amount and Manual Entry CVV.

Confirm Sale Amount: When checked will require that the customer confirm the sale amount on the card reader. Despite being an extra step this is a best practice to have the customer confirm the amount they are putting on their card.

Manual Entry CVV: When checked this requires that the CVV be entered when manually keying in a customers card information.

Signature: When checked will require a customer signature. Hardly anyone does this anymore.

Use Device Printer: This really only functions with the Clover units (Flex and Mini) that have built in receipt printers.

Beep: When checked the card reader will beep when ready for process the card and when the card hasn't been removed from the unit. Don't turn this on for Ingenico units. You can't alter the volume/pitch and it's pretty awful.

Enter Zip Code: When checked it will require the customer to enter their zip code on the device to process the transaction. No one uses this, but it's an option like you see at a Gas pump.

Accept Debit: When checked this will accept debit as debit and not credit. This has been in your contract with Pineapple Payments to process debit as debit.

We also have the option to show Tips on Pin Pads - Tips have to be set up in a few other locations in iM (TIP SETUP), but in this window is where you would set the suggested % value of Tips. Generally this will only be used on Pin Pads at Cafe registers.

The Test Connection to Device button is helpful in setting up the Pin Pads. Once you have all settings filled out. Click on the Test Connection to Device button. If the test comes back with Success message, then you are good to go on to the next step. If not, then we still can't communicate with your device.

Click Save and Close and move on to your next pin pads if you have them.

Go To: Tools > Administration > PC Settings

Find and Select the PC that you want to tie the Pin Pad

Within PC Setting Properties Pineapple Device - assign the Pin Pad you want to use with this PC and check the Use box - be certain to uncheck ChargeItPro or Datacap Device if this PC was previously using either Pin Pad type.

Save and Close

Open POS - process a sale, select Credit Card as tender, and follow the Pin Pad Prompts. If POS was open, you will need to exit and reopen POS for these changes to take effect.

If for any reason you come across an error in processing the cards, please take a screenshot of the error and contact iMRCHNT [email protected]