Samsung Pay

Paylands allows your business to offer Samsung Pay as a payment method. Paylands is registered on Samsung Pay as a payment gateway, so Paylands onboards your business on Samsung Pay and processes the payments.

Merchant onboarding

When Samsung Pay is configured, Paylands creates a service and a merchant linked to your account on Samsung Pay, using the data it already has about you:

Samsung Pay data	Source
Service name	Your name in Paylands
Countries	The country of your Paylands profile, plus the ones you add
MCC codes	Those of your payment services in Paylands
Merchant name	The one you set. By default, the display name of your profile or, failing that, your name
Authorized domains	The ones you set. By default, the Paylands checkout domains

The merchant name shown to shoppers can only be set when onboarding, since Samsung Pay does not allow changing it afterwards.

Configuration steps

1. Log in to the Paylands panel.
2. Go to Configuration → Alternative Methods → Samsung Pay.
3. Optionally, set the merchant name, the additional countries where you sell, the domains where the Samsung Pay button will be shown and whether to request the billing address or the cardholder name.
4. Save the configuration.

Paying with Samsung Pay

Samsung Pay returns a network token (DPAN) encrypted with the Paylands key. Paylands decrypts it and charges it through the checkout card service, without 3DS.

1. Simple integration

Add Samsung Pay as a payment method in the checkout configuration. The Samsung Pay button is shown in the Paylands checkout, and also in the checkout SDK through the samsung_pay() method, on compatible devices and browsers.

The Samsung Pay payment sheet uses:

• The card brands enabled in the checkout customization.
• The button color according to the checkout theme (light or dark).
• The order amount and currency.
• The merchant name and country of the Samsung Pay configuration.
• The Request billing address and Request cardholder name options of the Samsung Pay form. When enabled, Paylands stores that data in the order customer.

In the sandbox environment, the payment sheet is simulated with Samsung test cards, without needing a Samsung device.

2. Advanced integration

If you integrate the Samsung Pay Web Checkout SDK in your own website:

1. Use the service_id of your Samsung Pay configuration as serviceId, and the merchant_id as merchant.id.
2. When Samsung Pay returns the paymentCredential, send it unchanged to Paylands through the Wallet payment endpoint, with wallet: SAMSUNGPAY.
3. Paylands decrypts the credential, processes the payment and returns the result. Report the result to Samsung Pay with notify().

{
  "signature": "121149a0ba5361191d740fa898784a8b",
  "order_uuid": "1F405EA3-9798-42A6-9E87-BD347EF67F55",
  "wallet": "SAMSUNGPAY",
  "payload": {
    "method": "3DS",
    "card_brand": "visa",
    "card_last4digits": "8226",
    "3DS": { "type": "S", "version": "100", "data": "<JWE>" }
  }
}

Service status

Samsung Pay creates the service with the Debugging status. The status is managed by Samsung Pay and can be checked on the panel:

Status	Description
Debugging	The service is in development and not yet released
Verifying	The service is pending Samsung approval
Approved	The service is active for online payments
Blocked	The service is inactive and cannot be used

Configuration via API

If your business is a partner, in addition to configuring Samsung Pay from the panel you can do it for your merchants through the Configure Samsung Pay and Delete Samsung Pay endpoints.

The request onboards the merchant indicated in client_uuid on Samsung Pay if it was not onboarded, or updates its configuration otherwise. The merchant must belong to the client making the request. All fields are optional: merchant_name, locations (additional countries in ISO 3166 alpha-2 format), domains, is_billing_address_required, is_cardholder_name_required and is_enabled.

Example

{
  "signature": "121149a0ba5361191d740fa898784a8b",
  "client_uuid": "8dc780e8-c311-4791-a47f-c1a272ffbb87",
  "merchant_name": "Jhon Doe Shop",
  "locations": ["PT"],
  "domains": ["api.paylands.com", "ws-paylands.paynopain.com"]
}