To provide a consistent payment experience for Clover merchants, you must test and validate your app integration. This includes verifying all payment flows for the region where a merchant does business. Regional laws and regulations may affect the types of transactions a merchant can perform, so you must complete the tests for every region where your integrated app is intended for use.

The test scenarios provide steps to confirm your integration properly processes the transactions required for the European region. For more information on transactions, see United Kingdom and Ireland merchants.

Prerequisites to test European region payment flows

1. Use test cards

You must conduct tests using a Dev Kit configured for the sandbox environment. The test card numbers used for some tests return correct responses only in the sandbox. Use the test cards provided with your Clover Dev Kit to:

• Test each payment flow and make sure your application processes the payment as expected.
• Complete the tests required for Clover approval.
• Record a video of each transaction for Clover approvers to review that the point of sale (POS) handles the entire payment flow correctly. Keep both the POS and Clover device in the frame during the entire video. See Submit your application information and videos by email.

You can:

• Purchase chip and NFC functionality cards from B2, if needed.
• Use the following test card for the test scenarios in this topic:

2. Configure signature settings

To confirm that your application handles signatures correctly during the tests, your Clover device must be set to take the signature on the screen.

1. On the Clover device, open the Setup app.
2. From the left navigation menu, tap Payments.
3. In the Signature Settings section, tap Signature entry location, and verify On tablet screen is selected.
4. Tap Save.
5. Tap Signature Requirement and verify Always require signature is selected.
6. Tap Save. The signature settings are configured.

3. Configure tips setting

To confirm that your application handles tips correctly during the remaining tests, your Clover device must be set up to ask for a tip on the screen.

1. On the Clover device, open the Setup app.
2. From the left navigation menu, tap Tips.
3. Tap Ask for tip and verify the Ask for tip setting is Enabled.
4. Tap Tip entry location and verify On tablet screen is selected.
5. Tap Save. The tip settings are configured.

Scenarios—Test European region payment flows

If your integration supports the REST Pay payment flows, your app approval requires that each of the following tests be completed. Integrations that support a subset of transaction types can skip the tests that do not apply. When recording your tests, make sure both the POS and Clover device are in the frame during the entire video.

Test #1: Sale with no tipping option and emailed receipt

The following sample is for a minimal effective request for this test:

{
  "amount": 5100,
  "receipt_email": "[email protected]",
  "externalPaymentId": "{externalPaymentId}"
}

1. (POS) Create a charge in the amount of $51.00.
2. (Clover) Swipe card number 6011 3610 0000 6668 (Discover, plastic).
3. (Clover) On the Select Account screen, tap Credit.
4. (Clover) On the Add Signature screen, draw a line, and tap Done.

Success criteria:

• Payment is processed without a tipping option.
• Transaction receipt is sent to the specified email address.

Test #2: Sale with tip at 15%

This test replicates the payment flow for quick service restaurants (QSR) and other merchants that request the customer for a tip before the card is presented. The POS should indicate that the total is updated with the tip amount.

The following sample is for a minimal effective request for this test. The test assumes you are not passing custom tipSuggestions in the request, and the device is configured to use the default tip settings.

//request #1 (tip)
{
  "baseAmount": 5100
}

//request #2 (payment)

{
  "amount": 5865,
  "receipt_email": "[email protected]",
  "externalPaymentId": "{externalPaymentId}"
}

1. (POS) Create a tip request for the baseAmount of $51.00.
2. (Clover) On the Add a Tip screen, tap 15%.
3. (POS) Create a charge for the amount of $58.65.
4. (Clover) On the Sale screen, verify the transaction total includes the tip.
5. (Clover) Swipe card number 6011 3610 0000 6668 (Discover, plastic).
6. (Clover) On the Select Account screen, tap Credit.
7. (Clover) On the Add Signature screen, draw a line, and tap Done.

Success criteria:

• Sale is complete.
• Transaction receipt is sent to the specified email address.

Test #3: Refund a transaction

The following sample is for a minimal effective request for this test:

{
  "fullRefund": true
}

1. (POS) Select the sale transaction from Test #1.
2. (POS) Refund the full amount of the sale.
3. (Clover) On the How would you like your receipt screen, tap None.

Success criteria: Refund is complete.