Semi-Integration FAQ

Common Questions

Why can’t I connect to Clover Mini or initiate take payment through Clover Mini?

Check to see if Cloud Pay was deleted

You need to re-download Cloud Pay from either the web dashboard or on the Clover Mini.

To download Cloud Pay from Clover Mini:

  1. Open the App Market
  2. Tap to open the Cloud Pay app card
  3. Tap Free – Subscribe
  4. Tap Accept & Install in the Install App summary pop-up
  5. After the app has installed, tap the sync button in the upper-right corner of the App Market
Check to see if Cloud Pay needs to be updated

First, press the sync button in the upper-right corner of the Register app.

If an app update option doesn’t appear, you can redownload Cloud Pay from the Clover Mini:

  1. Open the App Market
  2. Tap to open the Cloud Pay app card
  3. Tap Uninstall
  4. Tap OK in the confirmation pop-up
  5. Tap Free – Subscribe
  6. Tap Accept & Install in the Install App summary pop-up
  7. After the app has installed, tap the sync button in the upper-right corner of the App Market

 

Check to see if Cloud Pay can launch

First, press the sync button in the upper-right corner of the Register app.

If an app update option doesn’t appear, you can redownload Cloud Pay from the Clover Mini:

  1. Open the App Market
  2. Tap to open the Cloud Pay app card
  3. Tap Uninstall
  4. Tap OK in the confirmation pop-up
  5. Tap Free – Subscribe
  6. Tap Accept & Install in the Install App summary pop-up
  7. After the app has installed, tap the sync button in the upper-right corner of the App Market
Check to see if the web app got deleted
  1. Login to your Clover Web Dashboard
  2. Open the App Market
  3. Click to open the Cloud Pay app card
  4. Click Uninstall
  5. Click OK in the confirmation pop-up
  6. Click Free – Subscribe
  7. Click Accept & Install in the Install App summary pop-up
  8. After the app has installed, tap the sync button in the upper-right corner of the App Market

Why is the Clover Mini not displaying the capture signature screen or sending the signature back to the POS UI for approval?

Check to see if Signature on screen is enabled
  1. Open the Setup app on Clover Mini
  2. Tap on the Payments tab
  3. Ensure that Signature entry location is set to On tablet screen
  4. Ensure that Signature requirement is set to Always require signature

Why is the Clover Mini not displaying the enter tip amount in the sale transaction flow?

Check to see if Tip on Screen is enabled
  1. Open the Setup app on Clover Mini
  2. Tap on the Tips tab
  3. Ensure that Ask for tip (always requires signature) is enabled
  4. Ensure that Tip entry location is set to On tablet screen

Why is the merchant unable to manually close the order batch?

The merchant can choose to manually close the batch on Clover Mini or to set the Clover Mini to automatic batch closeout.

To manually close the batch through Clover Mini
  1. Exit the Cloud Pay Display app by placing fingers on all four corners of the Clover Mini’s screen
  2. Open the Closeout app
  3. Tap on the Current Batch
  4. Tap on Close Out All Devices
    Note

    If there are any Open Tips, resolve them by tapping on View Open Tips

     

How can I set my batch processing to manual OR automatic?

Please contact your customer support number to change how your account is configured with respect to processing.

It has been over 24 hours and I still haven’t received my funds from the previous day’s transactions

If your account is configured to batch process manually, then you most likely forgot to close out at the end of the day. To close out, exit the Cloud Pay app on your Clover device (using the four finger pinching gesture that is displayed when you launch Cloud Pay), open the Close Out app and follow the instructions (make sure to close out for the day you are inquiring about). If you followed the steps above or are configured to batch automatically, and still haven’t received funds, please contact support.

Connecting

Between the three connection options (REST, Websocket, and directly via USB), how come I can only connect to one and none of the others?

This was a problem seen frequently from installations using the installer packets from below version 0.6. If you used one of these old installers to set up your DLLs and drivers, and if you selected more than one service during installation, then what’s happening now is the services are interfering with one another. Only one service can run at a time, and all three are set to run by default. As a short-term solution, you can manually kill whichever services you are not planning on using at this time. As a long term solution, uninstall the entire Clover package and reinstall using version 0.6 or higher.

Can I connect to a Clover device over LAN instead of USB?

This is a feature that is usually asked for when the physical environment necessitates that the Mini and the POS be physically separated. E.G. A ticketing booth or doctor’s office (glass window separating Clover Mini from the POS), a large store (Mini’s physically very far away from POS), a POS that is really a local server running in house, etc.

This feature is coming soon, in Q1 of 2017. It is necessary for both the IOS SDKs and connections to the Clover mini.

Development

How can I find my merchant ID?

After you log in to your merchant account at sandbox.dev.clover.com, the merchant ID is the 13 character, alphanumeric value at the end of the url.

Do you have example POS connections for Android, Browser, & iOS?

Do you have Java SDKs?

Not at this time. If this is something you are interested in, please submit a request through semi-integrations@clover.com.

My merchants are unable to install the Pay Display apps. What can I do?

Please call Clover Customer Support to resolve this issue.

Do you support pay at the table?

There is a beta version at this time. If you are interested, please submit a request through devask.clover.com and somebody will contact you.

How can I disable Partial Auth?

At this time, there is no way to disable Partial Auth. We are working on a feature that will provide a way to make partial authorizations something that merchants can opt-into. For more information, see the link below.

https://devask.clover.com/question/4995/can-i-turn-partial-authorizations-off/

My Devkit device indicates it is offline but it is connected to the internet, why is this happening?

You will likely be alerted to this problem when you try to take a payment and continually get an error message. E.G. “Transaction Failed: Not Connected” or “Transaction Declined: Failed To Connect To Server.” To make sure this is your problem, look at the wifi icon at the top right. If it is showing a strong connection, go to the Help App and look at Diagnostics (available by tapping the 3 horizontal bars to access the Menu and then tapping “Diagnostics” from the drop down selection). If it shows “Server disconnected” then you are experiencing this issue. For troubleshooting, click here:

https://devask.clover.com/question/4771/my-devkit-device-indicates-it-is-offline-but-it-is-connected-to-the-internet-why-is-this-happening/

I’d like to access the customer signatures later, how can I do that?

All options only valid for when signature is taken on screen (not taken on paper).

Option 1: Retrieve from the SDK response and store on your servers

You can get the signature from the verify signature request object that the Mini sends after a customer signs. Post retrieval, you can then store on your own servers.

 

Option 2: Retrieve from Clover Servers

Signatures taken on tablet are stored forever on the Clover servers. Using the Payment ID from a transaction you can go to https://dev1.dev.clover.com/p/PAYMENTID to get the receipt, and

https://dev1.dev.clover.com/cos/v1/dashboard/payment/PAYMENTID/signature.png to get a png file of the signature. 

For example:

receipt: https://dev1.dev.clover.com/p/XVCJAE7BGVYJ8 

signaturehttps://dev1.dev.clover.com/cos/v1/dashboard/payment/XVCJAE7BGVYJ8/signature.png 

You can do a web call at the end of a transaction to grab this file. It is impossible to resize the file.

The payment ID is usually printed right beneath the barcode on a receipt. To test it for yourselves, just do a test transaction on the mini and print the receipt off of the mini as well, then look there. For production purposes, you should be receiving the payment ID after a transaction completes, and you can use that to make the web call.

I want to print my own receipts, how can I repress the Clover receipts?

This is a fairly frequent request. There is a way to do this, but one (important) caveat is that Clover receipts are 100 percent compliant. If you are unsure whether or not your receipts meet the compliance standards necessary for EMV transactions, then it may be safer to continue printing ours.

That warning aside, suppressing Clover receipts involves passing a “no receipt” command to the Mini after the “choose receipt option” screen appears. It is possible to send the command programmatically through the SDKs, thus moving past the “choose receipt option” screen quickly enough for the user not to have time to make a choice. After doing so, you can then print your own receipt.

For example, the CloverExamplePOSForm can have its OnDeviceActivityStart method edited as such:


public void OnDeviceActivityStart(CloverDeviceEvent deviceEvent)
{
   foreach (InputOption io in deviceEvent.InputOptions)
   {
      if (io.description == "No receipt")
      {
         cloverConnector.InvokeInputOption(io);
      }
   }
}

Can I connect to a Clover device over LAN instead of USB?

This is a feature that is usually asked for when the physical environment necessitates that the Mini and the POS be physically separated. E.G. A ticketing booth or doctor’s office (glass window separating Clover Mini from the POS), a large store (Mini’s physically very far away from POS), a POS that is really a local server running in house, etc.

This feature is coming soon, in Q1 of 2017. It is necessary for both the IOS SDKs and connections to the Clover mini.

Testing

Can I get test cards?

Your Dev Kits come with 2 test cards.

How can I test a partial auth?

You may test a partial auth by means of manual entering a special test card that is designed to always authorize half of the amount of the sale.

Requirements:

  1. Your test merchant must be on a CERT environment, and not pointed to blackhole. Most sandbox devices that are shipped are pointed to a blackhole processing account, which by default accepts everything. This, obviously, won’t work if you’re testing failures or partial authorizations. To check if you are on a CERT account, send an email to semi-integrations@clover.com with your test merchant ID and Name and request for somebody to check for you. If you are not on a CERT account, request to be put on one.
  2. Your integration payment options must include manual entry, otherwise, there will be no way for you to manually enter a card while the mini is in customer facing mode. You will need to set the cardEntryMethod on the SaleRequest/AuthRequest to include manual entry as an option. By default, it is not enabled. There are CardEntryMethod constants defined you can OR together in the SaleRequest/AuthRequest. https://github.com/clover/remote-pay-cloud/blob/master/CardEntryMethods.js
  3. You MUST be connected to the internet. It is NOT enough that you know the device is on a strong network. Check the Help app to view the connectivity of your Mini. If your Mini is on the internet, but still shows up as disconnected, try this: https://devask.clover.com/question/4771/my-devkit-device-indicates-it-is-offline-but-it-is-connected-to-the-internet-why-is-this-happening/

Steps:

  1. Take a payment normally from your 3rd party POS. When it comes time to pay on the Mini, hit the button that allows manual card entry.
  2. Enter this card number: 4005578003333335, no CVV, and any expiration date set into the future.
  3. Your transaction should complete for 1/2 of the card amount. You must then issue a new transaction for the second half.
  4. If you have difficulty, check the list of requirements.

 

Please see more details here:

https://devask.clover.com/question/2466/clover-remote-pay-windows-test-amounts-to-simulate-declines-etc/