Servicio LaunchPad
El servicio LaunchPad permite el envío de emails y SMS con enlaces para poder realizar las operaciones execute_purchase
, create_subscription
y create_preauthorization
.
Importante
Este servicio tiene ciertas limitaciones de uso y conlleva gastos adicionales. Si deseas usar la integracion LaunchPad ponte en contacto con PAYCOMET..
Introducción
Las tecnologías disponibles para la realización de las operaciones son XML (protocolo SOAP) y REST (formato JSON). Ambas permiten la consulta mediante protocolo seguro por firewalls y a través de la red.
Este servicio tiene ciertas limitaciones de uso y conlleva gastos adicionales. Si deseas usar la integracion LaunchPad ponte en contacto con PAYCOMET.
¡Recuerda!
El entorno sólo trabajará sobre protocolo seguro SSL.
Debido a que todo el proceso de consulta se realiza en segundo plano (de servidor a servidor) las modificaciones a realizar en el comercio son totalmente ajenas a la experiencia de usuario.
Las peticiones se realizan mediante el protocolo de transporte HTTPS, de manera que debes asegurarte de que tu sistema es capaz de realizar las peticiones correctamente y gestionar los certificados de seguridad devueltos por la plataforma para una correcta utilización.
Importante
La integración XML está obsoleta. Recomendamos usar la integración REST.
Llamada al servicio execute_purchase
A continuación, selecciona el tipo de integración:
La integración de esta función en REST está detallado en su documentación completa, disponible en este enlace
Endpoint del servicio:
https://api.paycomet.com/gateway/xml-launchpad?wsdl
Las variables que se requieren para enviar un enlace para ejecutar una autorización son:
Elemento | Contenido | Descripción |
---|---|---|
MERCHANT_MERCHANTCODE | [A-Za-z0-9]{1,8} | Obligatorio. Código de cliente |
MERCHANT_TERMINAL | [0-9]{1,5} | Obligatorio. Número de terminal |
MERCHANT_PRODUCTDESCRIPTION | [a-zA-Z0-9]{125} | Opcional (envíe el nodo vacío para que sea ignorado). Descripción del producto |
MERCHANT_CURRENCY | [EUR|USD|GBP|JPY] | Obligatorio. Moneda de la transacción. Ver más información en MONEDAS |
MERCHANT_AMOUNT | [0-9]{1,8} | Obligatorio. Importe de la operación en formato entero. 1,00 EURO = 100, 4,50 EUROS = 450... |
MERCHANT_ORDER | [A-Za-z0-9]{1,20} | Obligatorio. Referencia de la operación |
MERCHANT_MERCHANTSIGNATURE | [a-zA-Z0-9] | Obligatorio. Ver apartado Cálculo de la Firma |
MERCHANT_SCORING | [0-100] | Opcional (envíe el nodo vacío para que sea ignorado). Valor de scoring de riesgo de la transacción. Entre 0 y 100 |
MERCHANT_DATA |
JSON | Opcional (envíe el nodo vacío para que sea ignorado). Información de autenticación del cliente. Cuanta más información se proporcione en este campo, más probable será la autorización de la operación sin solicitar autenticación adicional. Por esta razón se recomienda el envío del máximo de información posible. Ver detalle |
MERCHANT_SCA_EXCEPTION |
[LWV|TRA|MIT|COR|MOT] | Opcional (envíe el nodo vacío para que sea ignorado). TIPO DE EXCEPCIÓN AL PAGO SEGURO. Si no se especifica PAYCOMET tratará de asignarle el más adecuado si fuera posible. Ver detalle |
MERCHANT_TRX_TYPE |
[I|R|H|E|D|M|N|C] | Condicional. Obligatorio sólo si se ha elegido una excepción MIT en el campo MERCHANT_SCA_EXCEPTION. Ver detalle |
SECURE | [0-1]{1} | Opcional (envíe el nodo vacío para que sea ignorado). Realización de la operación en modo seguro (valor 1) / no seguro (valor 0). Si no se informa: no seguro. |
LANGUAGE | [A-Za-z0-9]{2} | Obligatorio. Idioma del entorno de cobro ("ES","EN","FR","DE","IT") |
SMS_EMAIL | [SMS|EMAIL] | Obligatorio. Especifica el medio de envío del enlace de pago |
TEMPLATE_ID | [0-9]{1,5} | Obligatorio. Id de la plantilla de Email o SMS a enviar. Se puede obtener en el Panel de Control |
EMAIL_ADDRESS | Condicional. Obligatorio si es un envío por EMAIL. Dirección de email para el envío del enlace | |
EMAIL_NAME | [A-Za-z0-9]{1,100} | Condicional. Obligatorio si es un envío por EMAIL. Nombre del destinatario del email para el envío del enlace |
SMS_PREFIX | +[0-9]{1,5} | Condicional. Obligatorio si es un envío por SMS. Prefijo internacional del teléfono al que enviar el enlace |
SMS_NUMBER | [0-9]{1,12} | Condicional. Obligatorio si es un envío por SMS. Número del teléfono al que enviar el enlace |
EXPIRY_DATE | [0-9]{8} | Opcional. Fecha de caducidad del enlace. Formato YYYYMMDD. |
EXPIRY_HOUR | [0-9]{2} | Opcional. Hora de caducidad del enlace. Formato HH. |
EXPIRY_MINUTE | [0-9]{2} | Opcional. Minuto de caducidad del enlace. Formato MM. |
Información:
La descripción de la columna “Contenido” se refiere a la expresión regular que debe cumplir la información presente en el elemento correspondiente. De esta manera “[A-Z]” indica cualquier carácter de la “A” a la “Z” y los corchetes indican el número de caracteres. Por ejemplo “1{2,4}” valida los números “11”, “111” y “1111”.
La respuesta del servicio a la petición se realiza mediante la devolución de dos datos:
ERROR_ID
contendrá el error de integración del WEBSERVICE o será 0 en caso de éxito.ERROR_MESSAGE
contendrá la descripción del error o será "OK" si todo ha ido bien.
Cálculo de la firma
SHA512(MERCHANT_MERCHANTCODE + MERCHANT_TERMINAL + MERCHANT_AMOUNT + MERCHANT_ORDER + PASSWORD)
Ejemplo de uso
Mensaje de envío
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<execute_purchase>
<MERCHANT_MERCHANTCODE xsi:type="xsd:string">********</MERCHANT_MERCHANTCODE>
<MERCHANT_TERMINAL xsi:type="xsd:string">****</MERCHANT_TERMINAL>
<MERCHANT_PRODUCTDESCRIPTION xsi:type="xsd:string">Compra de producto</MERCHANT_PRODUCTDESCRIPTION>
<MERCHANT_CURRENCY xsi:type="xsd:string">EUR</MERCHANT_CURRENCY>
<MERCHANT_AMOUNT xsi:type="xsd:string">202</MERCHANT_AMOUNT>
<MERCHANT_ORDER xsi:type="xsd:string">TEST - PAYTPV - 428092</MERCHANT_ORDER>
<MERCHANT_MERCHANTSIGNATURE xsi:type="xsd:string">*******************************************</MERCHANT_MERCHANTSIGNATURE>
<MERCHANT_SCORING xsi:type="xsd:string"></MERCHANT_SCORING>
<MERCHANT_DATA xsi:type="xsd:string"></MERCHANT_DATA>
<MERCHANT_SCA_EXCEPTION xsi:type="xsd:string"></MERCHANT_SCA_EXCEPTION>
<MERCHANT_TRX_TYPE xsi:type="xsd:string"></MERCHANT_TRX_TYPE>
<SECURE xsi:type="xsd:int">0</SECURE>
<LANGUAGE xsi:type="xsd:string">es</LANGUAGE>
<SMS_EMAIL xsi:type="xsd:string">EMAIL</SMS_EMAIL>
<TEMPLATE_ID xsi:type="xsd:int">423</TEMPLATE_ID>
<EMAIL_ADDRESS xsi:type="xsd:string">********************</EMAIL_ADDRESS>
<EMAIL_NAME xsi:type="xsd:string">****************</EMAIL_NAME>
<SMS_PREFIX xsi:type="xsd:string"></SMS_PREFIX>
<SMS_NUMBER xsi:type="xsd:string"></SMS_NUMBER>
</execute_purchase>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Mensaje de respuesta
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<SOAP-ENV:execute_purchaseResponse>
<ERROR_ID xsi:type="xsd:integer">0</ERROR_ID>
<ERROR_MESSAGE xsi:type="xsd:string">0</ERROR_MESSAGE>
</SOAP-ENV:execute_purchaseResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Llamada al servicio create_subscription
A continuación, selecciona el tipo de integración:
La integración de esta función en REST está detallado en su documentación completa, disponible en este enlace
Endpoint del servicio:
https://api.paycomet.com/gateway/xml-launchpad?wsdl
Las variables que se requieren para enviar un enlace para crear una suscripción son:
Elemento | Contenido | Descripción |
---|---|---|
MERCHANT_MERCHANTCODE | [A-Za-z0-9]{1,8} | Obligatorio. Código de cliente |
MERCHANT_TERMINAL | [0-9]{1,5} | Obligatorio. Número de terminal |
MERCHANT_CURRENCY | [EUR|USD|GBP|JPY] | Obligatorio. Moneda de la transacción. Ver más información en MONEDAS |
MERCHANT_AMOUNT | [0-9]{1,8} | Obligatorio. Importe de la operación en formato entero. 1,00 EURO = 100, 4,50 EUROS = 450... |
MERCHANT_ORDER | [A-Za-z0-9]{1,20} | Obligatorio. Referencia de la operación |
MERCHANT_MERCHANTSIGNATURE | [a-zA-Z0-9] | Obligatorio. Ver apartado Cálculo de la Firma |
MERCHANT_SCORING | [0-100] | Opcional (envíe el nodo vacío para que sea ignorado). Valor de scoring de riesgo de la transacción. Entre 0 y 100 |
MERCHANT_DATA |
JSON | Opcional (envíe el nodo vacío para que sea ignorado). Información de autenticación del cliente. Cuanta más información se proporcione en este campo, más probable será la autorización de la operación sin solicitar autenticación adicional. Por esta razón se recomienda el envío del máximo de información posible. Ver detalle |
SUBSCRIPTION_STARTDATE | [0-9]{8} | Obligatorio. Fecha de inicio de la suscripción yyyymmdd IMPORTANTE: Las suscripciones se cobran en la primera ejecución si este campo tiene valor se tendrá en cuenta para los futuros cargos. |
SUBSCRIPTION_ENDDATE | [0-9]{8} | Obligatorio Fecha de fin de la suscripción yyyymmdd |
SUBSCRIPTION_PERIODICITY | [0-9]{1-3} | Obligatorio Periodicidad de la suscripción. Expresado en días. Como máximo, 365 |
SECURE | [0-1]{1} | Opcional (envíe el nodo vacío para que sea ignorado). Realización de la operación en modo seguro (valor 1) / no seguro (valor 0). Si no se informa: no seguro. |
LANGUAGE | [A-Za-z0-9]{2} | Obligatorio. Idioma del entorno de cobro ("ES","EN","FR","DE","IT") |
SMS_EMAIL | [SMS|EMAIL] | Obligatorio. Especifica el medio de envío del enlace de pago |
TEMPLATE_ID | [0-9]{1,5} | Obligatorio. Id de la plantilla de Email o SMS a enviar. Se puede obtener en el Panel de Control |
EMAIL_ADDRESS | Condicional. Obligatorio si es un envío por EMAIL. Dirección de email para el envío del enlace | |
EMAIL_NAME | [A-Za-z0-9]{1,100} | Condicional. Obligatorio si es un envío por EMAIL. Nombre del destinatario del email para el envío del enlace |
SMS_PREFIX | +[0-9]{1,5} | Condicional. Obligatorio si es un envío por SMS. Prefijo internacional del teléfono al que enviar el enlace |
SMS_NUMBER | [0-9]{1,12} | Condicional. Obligatorio si es un envío por SMS. Número del teléfono al que enviar el enlace |
EXPIRY_DATE | [0-9]{8} | Opcional. Fecha de caducidad del enlace. Formato YYYYMMDD. |
EXPIRY_HOUR | [0-9]{2} | Opcional. Hora de caducidad del enlace. Formato HH. |
EXPIRY_MINUTE | [0-9]{2} | Opcional. Minuto de caducidad del enlace. Formato MM. |
Información:
La descripción de la columna “Contenido” se refiere a la expresión regular que debe cumplir la información presente en el elemento correspondiente. De esta manera “[A-Z]” indica cualquier carácter de la “A” a la “Z” y los corchetes indican el número de caracteres. Por ejemplo “1{2,4}” valida los números “11”, “111” y “1111”.
La respuesta del servicio a la petición se realiza mediante la devolución de dos datos:
ERROR_ID
contendrá el error de integración del WEBSERVICE o será 0 en caso de éxito.ERROR_MESSAGE
contendrá la descripción del error o será "OK" si todo ha ido bien.
Cálculo de la firma
SHA512(MERCHANT_MERCHANTCODE + MERCHANT_TERMINAL + MERCHANT_AMOUNT + MERCHANT_ORDER + PASSWORD)
Llamada al servicio create_preauthorization
A continuación, selecciona el tipo de integración:
La integración de esta función en REST está detallado en su documentación completa, disponible en este enlace
Endpoint del servicio:
https://api.paycomet.com/gateway/xml-launchpad?wsdl
Las variables que se requieren para enviar un enlace para crear una preautorización son:
Elemento | Contenido | Descripción |
---|---|---|
MERCHANT_MERCHANTCODE | [A-Za-z0-9]{1,8} | Obligatorio. Código de cliente |
MERCHANT_TERMINAL | [0-9]{1,5} | Obligatorio. Número de terminal |
MERCHANT_PRODUCTDESCRIPTION | [a-zA-Z0-9]{125} | Opcional (envíe el nodo vacío para que sea ignorado). Descripción del producto |
MERCHANT_CURRENCY | [EUR|USD|GBP|JPY] | Obligatorio. Moneda de la transacción. Ver más información en MONEDAS |
MERCHANT_AMOUNT | [0-9]{1,8} | Obligatorio. Importe de la operación en formato entero. 1,00 EURO = 100, 4,50 EUROS = 450... |
MERCHANT_ORDER | [A-Za-z0-9]{1,20} | Obligatorio. Referencia de la operación |
MERCHANT_MERCHANTSIGNATURE | [a-zA-Z0-9] | Obligatorio. Ver apartado Cálculo de la Firma |
MERCHANT_SCORING | [0-100] | Opcional (envíe el nodo vacío para que sea ignorado). Valor de scoring de riesgo de la transacción. Entre 0 y 100 |
MERCHANT_DATA |
JSON | Opcional (envíe el nodo vacío para que sea ignorado). Información de autenticación del cliente. Cuanta más información se proporcione en este campo, más probable será la autorización de la operación sin solicitar autenticación adicional. Por esta razón se recomienda el envío del máximo de información posible. Ver detalle |
MERCHANT_SCA_EXCEPTION |
[LWV|TRA|MIT|COR|MOT] | Opcional (envíe el nodo vacío para que sea ignorado). TIPO DE EXCEPCIÓN AL PAGO SEGURO. Si no se especifica PAYCOMET tratará de asignarle el más adecuado si fuera posible. Ver detalle |
MERCHANT_TRX_TYPE |
[I|R|H|E|D|M|N|C] | Condicional. Obligatorio sólo si se ha elegido una excepción MIT en el campo MERCHANT_SCA_EXCEPTION. Ver detalle |
SECURE | [0-1]{1} | Opcional (envíe el nodo vacío para que sea ignorado). Realización de la operación en modo seguro (valor 1) / no seguro (valor 0). Si no se informa: no seguro. |
LANGUAGE | [A-Za-z0-9]{2} | Obligatorio. Idioma del entorno de cobro ("ES","EN","FR","DE","IT") |
SMS_EMAIL | [SMS|EMAIL] | Obligatorio. Especifica el medio de envío del enlace de pago |
TEMPLATE_ID | [0-9]{1,5} | Obligatorio. Id de la plantilla de Email o SMS a enviar. Se puede obtener en el Panel de Control |
EMAIL_ADDRESS | Condicional. Obligatorio si es un envío por EMAIL. Dirección de email para el envío del enlace | |
EMAIL_NAME | [A-Za-z0-9]{1,100} | Condicional. Obligatorio si es un envío por EMAIL. Nombre del destinatario del email para el envío del enlace |
SMS_PREFIX | +[0-9]{1,5} | Condicional. Obligatorio si es un envío por SMS. Prefijo internacional del teléfono al que enviar el enlace |
SMS_NUMBER | [0-9]{1,12} | Condicional. Obligatorio si es un envío por SMS. Número del teléfono al que enviar el enlace |
EXPIRY_DATE | [0-9]{8} | Opcional. Fecha de caducidad del enlace. Formato YYYYMMDD. |
EXPIRY_HOUR | [0-9]{2} | Opcional. Hora de caducidad del enlace. Formato HH. |
EXPIRY_MINUTE | [0-9]{2} | Opcional. Minuto de caducidad del enlace. Formato MM. |
Información:
La descripción de la columna “Contenido” se refiere a la expresión regular que debe cumplir la información presente en el elemento correspondiente. De esta manera “[A-Z]” indica cualquier carácter de la “A” a la “Z” y los corchetes indican el número de caracteres. Por ejemplo “1{2,4}” valida los números “11”, “111” y “1111”.
La respuesta del servicio a la petición se realiza mediante la devolución de dos datos:
ERROR_ID
contendrá el error de integración del WEBSERVICE o será 0 en caso de éxito.ERROR_MESSAGE
contendrá la descripción del error o será "OK" si todo ha ido bien.
Cálculo de la firma
SHA512(MERCHANT_MERCHANTCODE + MERCHANT_TERMINAL + MERCHANT_AMOUNT + MERCHANT_ORDER + PASSWORD)