Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.pay-me.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Procedimiento de integración

Para el envío de la solicitud de pago se deberá generar una solicitud POST HTTPS, usando un formulario HTML, implementado en el lenguaje de programación del comercio o tienda virtual. Dependiendo del ambiente de integración, se deberá definir la URL del JavaScript correspondiente:
AmbienteDirección URL
Integraciónhttps://integracion.alignetsac.com/VPOS2/js/modalcomercio.js
Producciónhttps://vpayment.verifika.com/VPOS2/js/modalcomercio.js
La forma de integración entre el comercio y el V-POS2 es a través de JavaScript, donde este crea la función para invocar el diseño modal para el V-POS2. 
<head>
  <script type="text/javascript" src="https://integracion.alignetsac.com/VPOS2/js/modalcomercio.js"></script>
</head>
El comercio en su formulario de envío deberá agregar un tag “class” para identificar los parámetros de envío: 
<form name="f1" id="f1" action="#" method="post" class="alignet-form-vpos2">
El comercio en su botón de pago deberá llamar a la función JavaScript AlignetVPOS2.openModal(Dominio del ambiente):
AmbienteEjemplo
Integración<a href="javascript:AlignetVPOS2.openModal('https://integracion.alignetsac.com/','[TipoDeDiseño]')">Comprar</a>
Integración<input type="button" onclick="javascript:AlignetVPOS2.openModal('https://integracion.alignetsac.com/','[TipoDeDiseño]')" value="Comprar">
Producción<a href="javascript:AlignetVPOS2.openModal('','[TipoDeDiseño]')">Comprar</a>
Producción<input type="button" onclick="javascript:AlignetVPOS2.openModal('','[TipoDeDiseño]')" value="Comprar">
Para el ambiente de producción no es necesario indicar en la función JavaScript el dominio. Además, tendrá la opción de seleccionar el tipo de diseño a utilizar. Deberá ingresar el código del diseño (1, 2, o 3) en la función openModal, en la sección “[TipoDeDiseño]”.
La clave SHA-2 descargada en el paso de Generar Llaves del Comercio es necesaria para el envío de información.

​
Parámetros de envío

CampoTipoAncho máximoDescripciónReq.
acquirerIdNumérico4Código de adquirente proporcionado por la entidad afiliadora.SI
idCommerceNumérico4Código único de comercio proporcionado por la entidad afiliadora. Valor fijo.SI
purchaseOperationNumberNumérico6Identificador único por cada transacción, generado por el comercio. Considerar que deberán ser enviados los 6 caracteres obligatoriamente.SI
purchaseAmountNumérico10Valor total de la compra. Debe ir sin separador decimal (Si el monto es 100.30 dólares entonces la cantidad a enviar es 10030).SI
purchaseCurrencyCodeNumérico3Moneda según Estándar numérico ISO. Soles: 604 / Dólares: 840.SI
languageAlfanumérico2Idioma usado: español (SP), inglés (EN). Valor por defecto Español.SI
billingFirstNameAlfanumérico30Nombre del tarjetahabiente como aparece en la tarjeta de crédito.NO
billingLastNameAlfanumérico50Apellido del tarjetahabiente como aparece en la tarjeta de crédito.NO
billingEMailCadena50Dirección electrónica del tarjetahabiente.SI
billingAddressAlfanumérico50Dirección del tarjetahabiente.NO
billingZIPAlfanumérico10Código Postal del tarjetahabiente.NO
billingCityAlfanumérico50Nombre de la ciudad del tarjetahabiente.NO
billingStateAlfanumérico2Primeros 2 caracteres del Estado, Departamento o Localidad del tarjetahabiente.NO
billingCountryAlfanumérico2Código ISO del país del tarjetahabiente.NO
billingPhoneAlfanumérico15Teléfono del tarjetahabiente.NO
shippingFirstNameAlfanumérico30Nombre de la persona que recibirá los bienes.SI
shippingLastNameAlfanumérico50Apellido de la persona que recibirá los bienes.SI
shippingEmailCadena50Email de la persona que recibirá los bienes.SI
shippingAddressAlfanumérico50Dirección de entrega del pedido del tarjetahabiente.SI
shippingZIPAlfanumérico10Código Postal de la entrega.SI
shippingCityAlfanumérico50Nombre de la ciudad de entrega.SI
shippingStateAlfanumérico15Nombre del estado/región o departamento de entrega.SI
shippingCountryAlfanumérico2Código ISO del país de entrega.SI
shippingPhoneAlfanumérico15Teléfono del lugar de entrega.NO
shippingDNIAlfanumérico10DNI de la persona que recibe los bienes.NO
HTTPSessionIdAlfanumérico30Sesión HTTP solo en el caso que el comercio lo requiera.NO
terminalCodeAlfanumérico12Código de terminal de la compra.NO
userCommerceAlfanumérico20Código de usuario del tarjetahabiente en el comercio. En Wallet el parámetro es codCardHolderCommerce.SI
userCodePaymeAlfanumérico30Código de asociación con Wallet para el usuario. En Wallet el parámetro es codAsoCardHolderWallet.SI
descriptionProductsAlfanumérico30Descripción del producto o servicio comprado por el tarjetahabiente.SI
programmingLanguageAlfanumérico15Estipula el lenguaje de programación utilizado por el Comercio. Ejemplo: JAVA, PHP, VB.NET, PYTHON, RUBY, etc.SI
purchaseVerificationAlfanuméricoLongitud no fijaFirma digital de la trama de solicitud de pago. Contiene el valor cifrado de los campos acquirerId, idCommerce, purchaseOperationNumber, purchaseAmount, purchaseCurrencyCode y la clave SHA-2 para la pasarela.SI
reserved1 – reserved21Alfanumérico30Campos para datos adicionales no contemplados en el V-POS2.NO
reserved24 – reserved40Alfanumérico30Campos para datos adicionales no contemplados en el V-POS2.NO

​
Parámetros de respuesta

CampoTipoAncho máximoDescripción
authorizationResultNumérico2Resultado de la autorización: 00 transacción autorizada / 01 transacción denegada en el Banco Emisor / 05 transacción rechazada por el V-POS.
authorizationCodeAlfanumérico6Código de autorización de la transacción. Solo se devuelve en caso de transacción autorizada.
errorCodeAlfanumérico4Código de error en caso de denegación o rechazo. Este código no debe ser mostrado al tarjetahabiente.
errorMessageAlfanumérico-Descripción del código de error en caso de producirse un rechazo. Este mensaje no debe ser mostrado al tarjetahabiente.
answerCodeAlfanumérico-Código de respuesta de la procesadora con la cual se efectuó el pago.
answerMessageAlfanumérico-Mensaje de respuesta que describe el valor del campo answerCode.
binAlfanumérico6Primeros 6 números de la tarjeta de pago. Solo se envía en caso de estar disponible.
brandAlfanumérico12Descripción de la marca. Valores posibles: VISA, MC, AMEX, DN.
paymentReferenceCodeAlfanumérico-Número de tarjeta enmascarado (ejemplo: 414243******1234). Para otros medios se devolverá el código respectivo.
purchaseVerificationAlfanuméricoLongitud no fijaFirma generada con SHA-2 en base a los campos: acquirerId, idCommerce, purchaseOperationNumber, purchaseAmount, purchaseCurrencyCode, authorizationResult y la clave SHA-2 para la pasarela.
reserved1 – reserved21Alfanumérico30Campos para datos adicionales no revisados por el V-POS2.
reserved22Alfanumérico30Retorna el tipo de tarjeta: DEBIT o CREDIT. Contenido opcional sujeto a disponibilidad.
reserved23Alfanumérico30Retorna el nombre del Banco Emisor de la tarjeta. Contenido opcional sujeto a disponibilidad.
reserved24 - reserved40Alfanumérico30Campos para datos adicionales no revisados por el V-POS2.
IDTransactionAlfanumérico28Id de la transacción generada por Alignet para identificación del pedido con fines de trazabilidad.
txDateTimeAlfanumérico19Fecha y hora de registro de la transacción con el formato: DD/MM/AAAA HHMMSS.