Troubleshoot integration issues

The following instructions guide you in solving specific error situations related to your Samsung Pay integration.

This issue is commonly caused by an issuer name mismatch. Make sure that the issuer name configured in your service matches the issuer name associated with the card.

To find the issuer name associated with the card:

  1. Open the Samsung Wallet app.
  2. Tap the card to view its details.
  3. Open the menu on the top right, and select Customer services.
  4. The issuer name is displayed under the page title.

This error occurs if the device is incompatible with Samsung Pay or if the Samsung Wallet app is not installed. Use a compatible device and install the Samsung Wallet app.

If your app’s target API level is 30 or higher, you must also include a <queries> element in the AndroidManifest.xml file. For more information, see Add the Samsung Pay SDK for Android to your project.

This error occurs in the following circumstances:

  • The package name specified in the Samsung Pay Portal does not match the app’s actual package name.

    To check the package name:

    1. Log in to the Samsung Pay Portal.
    2. In the All Services section of your dashboard, click the app name for the applicable service.
    3. Locate the package name in the Service Details section.
  • The signature of the APK you uploaded does not match that of the APK you are using.

Fix the package name or APK, as needed.

This error occurs when the Samsung Account used for testing is not registered as a test account for the service.

To add a test account:

  1. Log in to the Samsung Pay Portal.
  2. In the All Services section of your dashboard, click the applicable service's name.
  3. Add the Samsung Account under Test Accounts and click SAVE.

Check the following:

  • If you integrate through a payment gateway, ensure the certificate signing request (CSR) uploaded during service creation is the payment gateway’s CSR, not a self-generated one.
  • Verify that the APK metadata complies with length limits:
    • Package name: 50
    • Version: 20
    • Signature: 100

This error occurs when the region set on the customer’s device is not among the countries configured for the service.

To add the device's country to your service:

  1. Log in to the Samsung Pay Portal.
  2. In the All Services section of your dashboard, click the applicable service's name.
  3. Click EDIT.
  4. Add the country in the Service Location field and click SAVE.

If the service is in the Requested or Approved status, you must go through the approval process again for the updated service.

This error occurs in the following circumstances:

  • The service has been deleted.
  • The service ID is invalid.

To verify the service ID:

  1. Log in to the Samsung Pay Portal.
  2. In the All Services section of your dashboard, click the applicable service's name.
  3. Locate the service ID in the Service Details section.

If the service has been deleted, create a new service.

This error occurs when the service is not in the Approved status.

To get your service approved, create a support ticket.

This error indicates that the Samsung Wallet app needs an update. Update the app as instructed and try again.

This error indicates that the Samsung Pay-related SDK version you are using is not allowed.

Use a valid version of the SDK. Samsung recommends using the latest version available on the Downloads and resources page.

This error occurs when Samsung Pay is used in a region where it is not supported.

To confirm supported regions, see Country and device availability.

This error indicates that the requested operation is not allowed; for example, your app verification has failed in the Samsung Pay server.

Create a support ticket and include the device dump logs.

This error is caused by an incorrectly constructed payload.

Ensure the payload follows your card network’s specification.

This error indicates the card is already registered.

Delete the card from the Samsung Wallet app and try again.

Create a support ticket and include the device dump logs.

This error occurs when the service is not in the Approved status.

To change the status of your service, request approval on the Samsung Pay Portal.