Need help?

Samsung Pay using Remote JSON API

Merchants seeking to display the Samsung Pay option directly on their website or mobile app can implement this integration.

To integrate Samsung Pay, merchants can utilize either the Web Checkout SDK or the Samsung Pay SDK to securely retrieve payment credentials.

Please follow the steps below to complete the integration:

Step 1: CSR for Samsung pay

Note: This step is not required if the merchant is PCI-DSS compliant and is using the network token in the API.

Merchants must contact the support team via email to enable Samsung Pay using the Remote JSON API.

Once Samsung Pay is enabled, log in to the merchant dashboard and navigate to Integrations > Wallets to complete the setup.

Option 1: CSR Creation using Telr dashboard

  1. If the Samsung Pay status is Enabled, click the "Generate" button under "Samsung Pay" to create a CSR.
  2. Wait for the page to reload. If successful, the CSR will be displayed on the page.
  3. Download the CSR by clicking on the file name. This CSR needs to be uploaded to Samsung Pay developer portal.

Option 2: Create your own private key and CSR

This option is for merchant who has multiple stores and which to use same CSR across the all the stores.

  1. Create private key and CSR using the below commands:
// Create Private Key
openssl genrsa -out private.key 2048

// Create CSR
openssl req -out CSR.csr -key private.key -new -sha256

// Verify CSR
openssl req -in CSR.csr -noout -text

// Convert private key to PEM
openssl pkcs8 -topk8 -inform PEM -outform PEM -in private.key -out pvtkey.pem -nocrypt

  1. Use CSR.csr file to upload in Samsung Pay developer portal.
  2. If the Samsung Pay status is Enabled, Upload pvtkey.pem using option 2 on Telrdashboard.

Step 2: Samsung Pay Developer Account Registration

Login or register with Samsung Pay developer portal using the link https://pay.samsung.com/developers

After login, follow the steps mentioned in https://developer.samsung.com/pay/native/about-this-guide.html

to create a service and to proceed with integration using "Web Checkout SDK" or "Samsung Pay SDK" as needed.

Step 3: Payment processing using Samsung Pay payload

  1. After the successful integration with Samsung Pay, next step is to process the payment using the samsung pay tokenized payment information.
  2. Call the Remote JSON API from your backend server to complete the transaction as using one of the two options mentioned in next page .