Create a new service in the Samsung Pay Portal

NoteService creation only applies to individual merchants and those payment gateways (PG) that provide ready-made solutions for their merchants. If you are a PG that only provides a simple framework for your merchants, you do not need to create services yourself. Instead, your merchants create their own services and select your PG during service creation.

To create a service:

Log in to the Samsung Pay Portal.
In the All Services section of your dashboard, click CREATE NEW.
Select one of the following service types based on your integration option, and click NEXT:
- InApp Online Payment, if you are using the Samsung Pay SDK for Android or Flutter
- Web Online Payment, if you are using the Web Checkout SDK
- W3C (Mobile Web), if you are using the W3C Payment Request
Configure your selected service type:
- InApp Online Payment:
  1. Enter the Service Name for your new service.
  2. Select your Service Location countries.
  3. Select your Merchant Category that best describes your business.
  4. Select your Payment Gateway from the list of supported payment gateways.
    
    If the PG you need is not yet registered and is not listed, select NONE temporarily. However, note that no payment processing is available for your service until a valid PG is selected.
  5. Drag the certificate signing request (CSR) file you have obtained from your PG to the CSR field. If your PG does not provide a CSR file, create your own. For more information, see Create a CSR file.
    
    The supported file formats are .CSR or .PEM.
  6. Select Staging or Production for the Environment to indicate whether the service is for testing or live use.
  7. Confirm your agreement with the portal's terms and conditions by ticking the check box.
  8. Click NEXT.
  9. If you are a PG, add merchants covered by your service (if you are a merchant, skip to the next step):
    1. Choose how to add merchants:
      - Click ADD MERCHANT to add merchants individually.
      - Click EXCEL UPLOAD to add merchants in bulk.
    2. Add merchant information:
      - For each merchant, enter the Merchant Name, Merchant ID, and Merchant Category, and then click SAVE.
      - For bulk upload, download the template, enter the merchant information, and upload the completed file.
    3. Click NEXT.
  10. Bind an app to the service. Select an existing app from the app list, or turn on the Create New App toggle and enter the app details below the app list to create and bind a new app.
  11. Click NEXT.
  12. Define test accounts and their debug expiration date.
- Web Online Payment:
  1. Enter the Service Name for your new service.
  2. Select your Service Location countries.
  3. Select your Merchant Category that best describes your business.
  4. Select your Payment Gateway from the list of supported payment gateways.
    
    If the PG you need is not yet registered and is not listed, select NONE temporarily. However, note that no payment processing is available for your service until a valid PG is selected.
  5. Drag the certificate signing request (CSR) file you have obtained from your PG to the CSR field. If your PG does not provide a CSR file, create your own. For more information, see Create a CSR file.
    
    The supported file formats are .CSR or .PEM.
  6. Enter all the payment domain names for your website in the Service Domain field one by one and click ADD after each name.
    
    For example, if your domain is mywebstore.com but the checkout page is hosted on the subdomain payments.mywebstore.com, enter payments.mywebstore.com as the Service Domain. Do not include the https:// prefix in the domain name.
  7. Select Staging or Production for the Environment to indicate whether the service is for testing or live use.
  8. Confirm your agreement with the portal's terms and conditions by ticking the check box.
  9. Click NEXT.
  10. If you are a PG, add merchants covered by your service (if you are a merchant, skip to the next step):
    1. Choose how to add merchants:
      - Click ADD MERCHANT to add merchants individually.
      - Click EXCEL UPLOAD to add merchants in bulk.
    2. Add merchant information:
      - For each merchant, enter the Merchant Name, Merchant ID, and Merchant Category, and then click SAVE.
      - For bulk upload, download the template, enter the merchant information, and upload the completed file.
    3. Click NEXT.
  11. Define test accounts and their debug expiration date.
- W3C (Mobile Web):
  1. Enter the Service Name for your new service.
  2. Select your Service Location countries.
  3. Select your Merchant Category that best describes your business.
  4. Select your Payment Gateway from the list of supported payment gateways.
    
    If the PG you need is not yet registered and is not listed, select NONE temporarily. However, note that no payment processing is available for your service until a valid PG is selected.
  5. Drag the certificate signing request (CSR) file you have obtained from your PG to the CSR field. If your PG does not provide a CSR file, create your own. For more information, see Create a CSR file.
    
    The supported file formats are .CSR or .PEM.
  6. Enter all the payment domain names for your website in the Service Domain field one by one and click ADD after each name.
    
    For example, if your domain is mywebstore.com but the checkout page is hosted on the subdomain payments.mywebstore.com, enter payments.mywebstore.com as the Service Domain. Do not include the https:// prefix in the domain name.
  7. Select Staging or Production for the Environment to indicate whether the service is for testing or live use.
  8. Confirm your agreement with the portal's terms and conditions by ticking the check box.
  9. Click DONE.

Create a CSR file

In Samsung Pay integrations, a CSR file is used to provide your public key for encrypting payment data. Unlike the standard certificate issuance process, the CSR is not used to request a certificate from a Certificate Authority (CA). Instead, Samsung Pay extracts the public key from the CSR you upload to the Samsung Pay Portal and uses it to encrypt order information and tokenized card data.

Perform the following steps to create a CSR file using OpenSSL:

Generate a private key:
```
openssl genrsa -out private.key 2048
```

Create a CSR file using the private key:

openssl req -new -key private.key -out request.csr

When prompted, provide the required information, such as:
- Common Name (CN): Service identifier or domain
- Organization (O): Company name
- Country (C): Country code

Note

The CSR contains the public key but does not include the private key.
Keep the private key secure. It is required to decrypt payment data.
Use a key length of at least 2048 bits.

Create a new service in the Samsung Pay Portal

Create a CSR file

Manage Your Cookies

Essential Cookies

Analytical/Performance Cookies

Functionality Cookies

Preferences Submitted