Test cases

Based on your integration option, follow the testing guidelines described in the following sections:

Web Checkout integration

To verify that Web Checkout works correctly on your website:

  • Test making a purchase:

    1. On your test device, open the Samsung Wallet test app and add one of the test cards in it.
    2. Open your website.
    3. Initiate a purchase through your website.
    4. To initialize the payment, click Pay with Samsung Pay.
    5. In the Samsung Wallet test app, select the test card and authorize the payment.

  • When the app works perfectly in the test environment, perform a similar test in the production environment.

    When testing in production, be careful and make sure to:

    • Use a released version of the Samsung Wallet app.
    • Be located in a region supported by your service.
    • Use the production environment when initializing the Samsung Pay client.
    • Use a supported card brand.
    • Use a small, negligible amount for the test.
    • After the payment succeeds, request a refund for the transaction from your payment provider.

During testing, confirm the following details:

  • For payment initialization on a desktop:

    • Make sure the Samsung Pay payment option appears with the logo correctly displayed.
    • After selecting Samsung Pay as the payment option:
      • The QR scanning and email options are displayed.
      • For the email option, the Next and Cancel buttons are displayed, along with the Forgot ID option for resetting the ID.
      • For QR scanning option, the session times out after 5 minutes and then returns to the checkout screen.
    • After scanning the QR code or clicking Next on the email input screen, a push notification arrives on the mobile device.

  • For payment initialization on a mobile device:

    • Make sure the Samsung Pay payment option appears with the logo correctly displayed.
    • After selecting Samsung Pay as the payment option, the Continue with Samsung Pay button is displayed.
    • After tapping Continue with Samsung Pay, the Samsung Checkout screen is displayed in your app along with:
      • Merchant domain name
      • Order summary (with the amount and product name)
      • Payment method, as "Samsung Pay"
      • Customer contact information (name, phone, email), in editable format
      • Continue and Cancel buttons

  • For payment confirmation in the Samsung Wallet test app:

    • A default card (either the last card used, or the card set as the default in the Samsung Wallet app settings) is displayed on the payment sheet.
    • The card name and the last 4 digits of the card number are displayed.
    • You can change the card if multiple cards are enrolled in the Samsung Wallet test app.
    • If billingAddress was specified in the API request, the billing address is displayed and can be updated.
    • The payment amount label displays as "Total" or "Total (estimated amount)" based on the amount.option value.
    • The merchant name is displayed.
    • The authentication option (PIN/biometrics) is displayed.
    • A blue "Verified" checkmark is displayed after payment confirmation.
    • If you are testing with real cards and the released version of the Samsung Wallet app, a transaction notification is displayed once the purchase is complete.

  • For payment completion on your website:

    • Verify that the screen that indicates payment completion is displayed on your website (desktop or mobile).

W3C Payment Request integration

To verify that W3C Payment Request works correctly on your website:

  1. In the test environment, perform the following steps and verify the functionality with the verification points:

    1. On a supported Samsung device, open the Samsung Wallet test app and add one of the test cards.
    2. Open your website with Samsung Internet or Google Chrome.
    3. Initiate a purchase and proceed to the checkout page.
    4. Select Samsung Pay as the payment method:
      • For branded implementations, tap Buy with Samsung Pay.
      • For standard W3C implementations, tap Checkout, select Samsung Pay from the list of payment options, and then tap Pay.
    5. When the Samsung Pay payment sheet is displayed, authenticate the payment.
    6. Complete the payment flow and verify the end-to-end result.

  2. Perform a similar test using an amount that is larger than the maximum allowed transaction amount (determined with your payment gateway and token service provider) and ensure that the transaction fails.

  3. Perform similar tests in the production environment.

    When testing in production, make sure to:

    • Use a released version of the Samsung Wallet app.
    • Be located in a region supported by your service.
    • Use a supported card brand.
    • Use a small, negligible amount for the test.
    • After the payment succeeds, request a refund for the transaction from your payment provider.

If issues occur, review browser logs and network traces, correct the integration as needed, and repeat testing.
For unresolved issues, contact your Samsung Pay team for troubleshooting support.

Verification points

During testing, confirm the following behaviors:

  • During payment initialization:

    • If you are using the standard W3C model, verify that:

      • On the browser payment sheet:
        • Samsung Pay appears as an available payment option, with the Samsung Pay logo displayed correctly.
        • The merchant name and domain name are displayed correctly.
        • The order summary is displayed and reflects the purchased items.
        • Pay and Cancel buttons are available.
      • On the Samsung Pay payment sheet:
        • The default card is displayed when only one card is enrolled.
        • You can change the payment card when multiple cards are enrolled.
        • The total payment amount is correct.
        • The components of the total amount are correct.
        • The billing address is displayed if supported by the integration.
        • The billing address can be changed, if supported.

    • If you are using the branded Samsung Pay model with options, verify that:

      • The Samsung Pay button is displayed correctly on the checkout page.
      • The browser payment sheet is displayed when Samsung Pay is selected, and on the payment sheet:
        • Samsung Pay appears as the only payment option, with the Samsung Pay logo displayed correctly.
        • The merchant name and domain name are displayed correctly.
        • The order summary is displayed and reflects the purchased items.
        • Shipping address input and changes are captured correctly.
        • Pay and Cancel buttons are available.
      • The Samsung Pay payment sheet opens after you tap Pay on the browser payment sheet, and on the payment sheet:
        • The default card is displayed when only one card is enrolled.
        • You can change the payment card when multiple cards are enrolled.
        • The total payment amount is correct.
        • The components of the total amount are correct.
        • The billing address is displayed if supported by the integration.
        • The billing address can be changed, if supported.
        • Shipping costs (if applicable) update based on the selected shipping address and are reflected in the total amount.

    • If you are using the branded Samsung Pay model without options, verify that:

      • The Samsung Pay button is displayed correctly on the checkout page.
      • The Samsung Pay payment sheet opens after Samsung Pay is selected, and on the payment sheet:
        • The default card is displayed when only one card is enrolled.
        • You can change the payment card when multiple cards are enrolled.
        • The billing address is displayed if supported by the integration.
        • The billing address can be changed, if supported.
        • The total payment amount is correct.
        • The components of the total amount are correct.

  • During payment completion, verify that:

    • The payment completes successfully after authentication.
    • A payment completion or confirmation screen is displayed after a successful payment.
    • A transaction notification is displayed in the Samsung Wallet app after a successful payment.

Samsung Pay SDK for Android or Flutter integration for card transactions

To verify that card transactions work correctly in your app:

  • Test making a purchase using the test environment:

    1. On your test device, open the Samsung Wallet test app and add one of the test cards in it.
    2. Open your app.
    3. Initiate a purchase through your app.
    4. For payment, click Pay with Samsung Pay.
    5. In the Samsung Wallet test app, select the test card and authorize the payment.

  • When the app works perfectly in the test environment, perform a similar test in the production environment.

    When testing in production, be careful and make sure to:

    • Use a released version of the Samsung Wallet app.
    • Be located in a region supported by your service.
    • Use a supported card brand.
    • Use a small, negligible amount for the test.
    • After the payment succeeds, request a refund for the transaction from your payment provider.