Pagos alternativos

  1. Introducción
  2. Autenticación
  3. Operativa
    1. Pagos directos
    2. Formulario con captura
  4. Documentación
    1. Documentación completa
    2. Especificaciones de métodos de pago

Introducción

El sistema te permitirá lanzar un pago por un medio de pago en concreto o permitir al cliente elegir entre los métodos de pago activados para tu comercio, con la posibilidad de hacer una selección sobre los mismos para un pago en concreto.

Autenticación

La integración REST utiliza un servicio de autenticación con APIKEYS, que se genera en el panel de control y debe incluirse en una cabecera de la petición. Para conocer más detalle, acude a la página gestión de APIKEYS.

Operativa

La operativa relacionada con los pagos alternativos permite realizar pagos directos a un método en concreto o generar un formulario con una plantilla, en la que el usuario podrá seleccionar el método de pago con el que realizar el pago entre los que tenga habilitados en la plataforma.

Por el momento, con métodos de pago alternativos tan sólo se podrán realizar autorizaciones en los pagos que el comercio tenga habilitado en PAYCOMET. El comercio puede consultar qué metodos tiene habilitados en su producto (función /methods).

Por otro lado, la operativa REST incorpora los cambios relativos a la normativa PSD2 (parámetro 'merchantData'), que será necesario cumplimentar en algunos de los pagos alternativos y, en todos los casos, servirá para facilitar la conversión de la operación. Puede consultar dichos parámetros en el recurso de Parámetros PSD2.

Pagos directos

El pago directo (función /payments) permite al comercio lanzar un pago con un método específico. Si no existe ningún error, PAYCOMET responderá con la URL a la que el comercio deberá redirigir al cliente, en caso de que sea necesaria una autenticación posterior. Si la operación no necesita SCA, el pago habrá sido finalizado correctamente.

Esta integración permite configurar el pago con usuario presente (parámetro 'userInteraction') y en entorno seguro (parámetro 'secure') para poder realizar operativas en los casos en los que se cumplen dichos condicionantes.


Ejemplo de pago directo

Petición:


{
  "payment": {
    "terminal": 999,
    "order": "PAY17123301",
    "amount": "202",
    "currency": "EUR",
    "originalIp": "127.0.0.1",
    "methodId": 11,   
    "secure": 1,
    "userInteraction": 1,
    "productDescription": "prueba docs.paycomet.com",
    "merchantData": {
      "customer": {
        "email": "jnadie@paycomet.com"
      }
    }
  }
}

Respuesta:


{
  "errorCode": 0,
  "amount": "202",
  "currency": "EUR",
  "methodId": 11,
  "order": "PAY17123301",
  "challengeUrl": "https://challenge.paycomet.com/challenge/WSsjX1htJEtuLXdXUikq"
}

Formulario con captura

El formulario con captura (función /form) permite al comercio lanzar un pago para permitir al usuario seleccionar el método de pago con el que desea pagar. Esta operativa está permitida para autorizaciones (en todos los métodos), preautorizaciones, subscripciones, alta de usuarios -tokenización-, autorizaciones por referencia y autorización con DCC (sólo con tarjeta).

El sistema permitirá elegir entre los métodos habilitados para el producto, permitiendo flexibilizar las opciones en la petición, mediante diversos parámetros:

  • En el parámetro methods se debe suministrar el listado de métodos disponibles para el cliente
  • En el parámetro excludedMethods recibirá los métodos excluidos, sino aparecen explícitamente en ‘methods’
  • Por defecto, el sistema mostrará los métodos habilitados para el comercio.

Por ejemplo, un comercio con cuatro métodos de pago habilitados (1 - Tarjeta, 10 - Bizum, 12 - iDEAL, 13 - Klarna Payments), quiere personalizar sus peticiones.

Opción Parámetros Métodos disponibles para el cliente
Mostrar todos los métodos, por defecto methods: [],
excludedMethods = []
Tarjeta, Bizum, iDEAL, Klarna Paynow
Incluir varios específicamente methods: [10,12] Bizum, iDEAL
Exclusión de un método methods: [],
excludedMethods = [1]
Bizum, iDEAL, Klarna Paynow

Si no existe ningún error, PAYCOMET responderá con la URL a la que el comercio deberá redirigir al cliente, donde el cliente seleccionará el pago entre los disponibles. En caso de que se incluya tarjeta entre los métodos, se permite incluir los parámetros relacionados con la tarjeta (idUser y tokenUser) permitiendo que el cliente no necesite volver a introducir la tarjeta.


Ejemplo de creación de formulario

Petición:


		{
	"operationType": 1, 
	"language": "es",
	"payment": {
		"terminal": 999,
	    "order": "FORM121286",
	    "amount": "707",
	    "currency": "EUR",
	    "secure": 1,
	    "userInteraction": 1,
	    "methods": [10,11],
	    "excludedMethods": [],
	    "originalIp": "127.0.0.1"
	}
}

Respuesta:


		{
    "errorCode": 0,
    "challengeUrl": "https://api.paycomet.com/gateway/restgateway/WSsjX1htJEtuLXdXUikq/es"
}

Documentación

Documentación completa

Para otras operaciones, incluidas las devoluciones para métodos de pago alternativos, deberás repasar la integración estándar o la documentación completa del servicio REST, en caso de querer consultar el detalle completo del servicio.

Especificaciones de métodos de pago

Para conocer las especificaciones de cada método de pago, deberás consultar el listado de métodos de pago disponibles.