Testing US payment flows

The following sections provide steps to confirm your integration properly processes the transactions required for the US. The video of each transaction allows Clover to see that the entire payment flow is handled correctly by the POS.

Preparing to test

The test card provided with your Clover DevKit allows you to test each flow and ensure your application processes the payment as expected. Ensure you have the test card available.

The tests required for Clover approval can be completed with the included test card. If you want to test chip and NFC functionality, test cards can be purchased from B2.

Card typeFormatNumberResponse
DiscoverPlastic6011 3610 0000 6668Success
VisaManual4005 5780 0333 3335Partial authorization for half of sale amount
VisaManual4005 5717 0222 2222Decline

Configure the 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. On the sidebar, 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.

Test payment flows

If your integration supports all of the available transaction types, each of the following flows must be successfully completed for your app to be approved. Integrations which support a subset of transaction types can skip the tests that do not apply.

🚧

IMPORTANT

When filming your tests, make the sure both the POS and Clover device are in frame during the entire video.

Test #1: Sale with tipping disabled (credit)

  1. (POS) Create a sale 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.
  5. (POS) Accept the signature.
  6. (Clover) On the Need a receipt screen, tap No receipt.
    The sale is processed with no tipping option presented.

Test #2: Refund a transaction

  1. (POS) Select the sale transaction from the first test.
  2. (POS) Refund the full amount of the sale.
  3. (Clover) On the Need a receipt screen, tap No receipt.
    The refund is complete.

📘

NOTE

Tests #3a and 3b cover partial authorizations and the two methods for handling them (paying the remaining balance or voiding the transaction). If your POS allows the merchant to choose either option, complete and record both tests. Otherwise, complete and record only the test that applies to your integration.

Test #3a: Sale with tipping disabled and partial authorization

This test shows that an integration handles a partial authorization by allowing the merchant and customer to complete the transaction with a second form of payment.

  1. (POS) Create a sale in the amount of $52.00.
  2. (Clover) On the Sale screen, tap Type Card.
  3. (Clover) Enter card number 4005 5780 0333 3335 (Visa, manual entry) and tap Enter.
  4. (Clover) For the CVV security code, enter any three-digit code and tap Enter.
  5. (Clover) For the Expiration Date, enter a month and year (MM/YY) in the future and tap Enter.
  6. (Clover) When a message is displayed asking to continue with the partial auth transaction, tap Yes.
  7. (Clover) On the Need a receipt screen, tap No receipt.
    Half of the sale amount is processed and the POS indicates this to the merchant.
  8. (POS) Click to acknowledge the partial payment.
  9. (POS) Start the next transaction to take the payment for the remaining balance.
  10. (Clover) On the Sale screen, swipe card number 6011 3610 0000 6668 (Discover, plastic).
  11. (Clover) On the Select Account screen, tap Credit.
  12. (Clover) On the Add Signature screen, draw a line and tap Done.
  13. (Clover) On the Need a receipt screen screen, tap No receipt.
  14. (Clover) On the All Done screen, tap anywhere to dismiss the message.
    The sale is complete.

Test #3b: Sale with tipping disabled and voided partial authorization

This test shows that an integration handles a partial authorization by voiding the original payment.

  1. (POS) Create a sale in the amount of $52.00.
  2. (Clover) On the Sale screen, tap Type Card.
  3. (Clover) Enter card number 4005 5780 0333 3335 (Visa, manual entry) and tap Enter.
  4. (Clover) For the CVV security code, enter any three-digit code and tap Enter.
  5. (Clover) For the Expiration Date, enter a month and year (MM/YY) in the future and tap Enter.
  6. (Clover) When a message is displayed asking to continue with the partial auth transaction, tap Yes.
  7. (Clover) On the Need a receipt screen, tap No receipt.
    Half of the sale amount is processed and the POS notifies the merchant of the partial payment.
  8. (POS) Click the merchant-facing option to void the original payment.
    The partially authorized payment is voided.

Test #4: Void a payment

  1. (POS) Select the sale transaction from the third test.
  2. (POS) Void the sale.
  3. (Clover) On the Need a receipt screen, tap No receipt.
    The void is complete and the device displays The transaction was voided.

Configure the tip setting

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

  1. On the Clover device, open the Setup app.
  2. On the sidebar, tap Tips.
  3. Tap Ask for tip and verify the Ask for tip check box is selected.
  4. Tap Save.
  5. Tap Tip entry location and verify On tablet screen is selected.
  6. Tap Save.
    The tip settings are configured.

Test #5: Sale with tipping enabled and no tip

  1. (POS) Create a sale in the amount of $51.00.
  2. (Clover) On the Add a Tip screen, tap No Tip.
  3. (Clover) Swipe card number 6011 3610 0000 6668 (Discover, plastic).
  4. (Clover) On the Select Account screen, tap Credit.
  5. (Clover) On the Add Signature screen, draw a line and tap Done.
  6. (POS) Accept the signature.
  7. (Clover) On the Need a receipt screen, tap No receipt.
    The sale is complete.

Test #6: Sale with tipping enabled and 15% tip

  1. (POS) Create a sale in the amount of $51.00.
  2. (Clover) On the Add a Tip screen, tap 15%.
  3. (Clover) On the Sale screen, verify the transaction total includes the tip.
  4. (Clover) Swipe card number 6011 3610 0000 6668 (Discover, plastic).
  5. (Clover) On the Select Account screen, tap Credit.
  6. (Clover) On the Add Signature screen, draw a line and tap Done.
  7. (POS) Accept the signature.
  8. (Clover) On the Need a receipt screen, tap No receipt.
    The sale is complete.

Test #7: Auth (transaction with tip adjustment)

This test requires that the POS has implemented auth transaction support and uses CloverConnector#tipAdjustAuth to update the transaction total. The POS should provide an indication that the total has been updated with the tip amount.

To perform this test, you must verify the Clover device's tip settings.

  1. Open the Setup app.
  2. Tap Tips.
  3. Verify the Ask for tip option is enabled.
  4. Tap Tip entry location, select the On printed receipt option, and tap Save.

Test steps:

  1. (POS) Create an auth in the amount of $51.00.
  2. (Clover) Swipe card number 6011 3610 0000 6668 (Discover, plastic).
    The device prints a receipt with a space for the tip and total amounts to be written by the customer.
  3. (POS) Select the transaction and adjust the tip amount.
    The transaction total is updated to reflect the tip.

Did this page help you?