Skip to content

Receive invoice and deposit payments with Clover

Clover is available in Settings > Payment Gateways for shops in the United States and Canada. Customers pay by card on Clover's own checkout page, and the money goes to the shop's Clover account. Clover's online checkout only exists in those two countries.

Connect your Clover account

You need three things from your Clover dashboard. Open Clover in Payment Gateways first: it shows the webhook URL you will paste in step 3.

  1. In the Clover dashboard, open Settings > Ecommerce > Ecommerce API Tokens and choose Create New Token. For the integration type pick Hosted checkout. Clover may ask you to turn on two-factor authentication first.
  2. Copy the Merchant ID (13 characters) and the private token into Stone Project.
  3. In the Clover dashboard, open Settings > Hosted Checkout. In Webhook URL, paste the URL shown in Stone Project, click Generate and save. Copy the Signing Secret into Stone Project's Webhook signing secret field.
  4. Turn the gateway Active, choose Default gateway if new portal payments should use Clover, and save. Test connection confirms that Clover accepts the merchant ID and the token.

Clover allows one Ecommerce API token per account. If you already have one for your website, you can use the same token; creating a new one replaces the old.

Use Sandbox with a Clover sandbox test merchant and Production with your real account.

What the customer sees

The customer opens the invoice or deposit link, chooses Continue with Clover and pays on Clover's page. Clover then sends them back to your portal.

Coming back to the portal does not confirm the payment by itself. The payment stays pending until Clover notifies Stone Project, which usually takes seconds. A declined card is recorded as declined, and the customer can try again on the same page. A Clover checkout page lasts 15 minutes; opening the payment link later gives the customer a fresh page for the same payment.

Refunds

Open the payment in Stone Project and use Refund, for the full amount or part of it. Stone Project sends the refund to Clover and updates the invoice balance. A refund made directly in the Clover dashboard is not reported back automatically: record it in Stone Project too.