Samsung Pay

Paylands permite a tu comercio ofrecer Samsung Pay como método de pago. Paylands está registrado en Samsung Pay como pasarela de pago, por lo que es Paylands quien da de alta tu comercio en Samsung Pay y procesa los pagos.

Alta del comercio

Al configurar Samsung Pay, Paylands crea en Samsung Pay un servicio y un comercio asociados a tu cuenta, y utiliza los datos que ya tiene de ti:

Dato en Samsung Pay	Origen
Nombre del servicio	Tu nombre en Paylands
Países	El país de tu perfil en Paylands, más los que añadas
Códigos MCC	Los de tus servicios de pago en Paylands
Nombre del comercio	El que indiques. Por defecto, tu nombre comercial del perfil o, en su defecto, tu nombre
Dominios autorizados	Los que indiques. Por defecto, los del checkout de Paylands

El nombre del comercio que se muestra a los compradores solo puede indicarse en el alta, ya que Samsung Pay no permite modificarlo después.

Pasos de configuración

1. Accede al panel de Paylands.
2. Ve a Configuración → Métodos Alternativos → Samsung Pay.
3. Opcionalmente, indica el nombre del comercio, los países adicionales en los que vendes, los dominios donde se mostrará el botón de Samsung Pay y si quieres solicitar la dirección de facturación o el nombre del titular.
4. Guarda la configuración.

Pago con Samsung Pay

Samsung Pay devuelve un token de red (DPAN) cifrado con la clave de Paylands. Paylands lo descifra y lo cobra por el servicio de tarjeta del checkout, sin necesidad de 3DS.

1. Integración simple

Añade Samsung Pay como método de pago en la configuración del checkout. El botón de Samsung Pay se muestra en el checkout de Paylands, y también en el SDK de checkout mediante el método samsung_pay(), en los dispositivos y navegadores compatibles.

La hoja de pago de Samsung Pay utiliza:

• Las marcas de tarjeta habilitadas en la personalización del checkout.
• El color del botón según el tema del checkout (claro u oscuro).
• El importe y la moneda del pedido.
• El nombre del comercio y el país de la configuración de Samsung Pay.
• Las opciones Solicitar dirección de facturación y Solicitar nombre del titular del formulario de Samsung Pay. Si se activan, Paylands guarda esos datos en el cliente del pedido.

En el entorno sandbox, la hoja de pago se simula con tarjetas de prueba de Samsung, sin necesidad de un dispositivo Samsung.

2. Integración avanzada

Si integras el Web Checkout SDK de Samsung Pay en tu propia web:

1. Usa como serviceId el service_id de tu configuración de Samsung Pay, y como merchant.id el merchant_id.
2. Cuando Samsung Pay devuelva la paymentCredential, envíala sin modificar a Paylands mediante el endpoint Pago con wallet, con wallet: SAMSUNGPAY.
3. Paylands descifra la credencial, procesa el pago y devuelve el resultado. Notifica el resultado a Samsung Pay con 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>" }
  }
}

Estado del servicio

Samsung Pay crea el servicio en estado En pruebas (Debugging). El estado lo gestiona Samsung Pay y puedes consultarlo en el panel:

Estado	Descripción
En pruebas (Debugging)	El servicio está en desarrollo y aún no se ha publicado
En verificación (Verifying)	El servicio está pendiente de aprobación por Samsung
Aprobado (Approved)	El servicio está activo para pagos online
Bloqueado (Blocked)	El servicio está inactivo y no puede usarse

Configuración vía API

Si tu comercio es partner, además de configurar Samsung Pay desde el panel puedes hacerlo para tus comercios mediante los endpoints Configurar Samsung Pay y Eliminar Samsung Pay.

La petición da de alta en Samsung Pay el comercio indicado en client_uuid si éste no lo estaba, o actualiza su configuración en caso contrario. El comercio debe pertenecer al cliente que realiza la petición. Todos los campos son opcionales: merchant_name, locations (países adicionales en formato ISO 3166 alfa-2), domains, is_billing_address_required, is_cardholder_name_required e is_enabled.

Ejemplo

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