Skip to main content
Skip table of contents

Parámetros de envío y respuesta

Parámetros de envío

A continuación, se detalla la lista de parámetros que el comercio debe enviar en el proceso de solicitud de pago:

Campo

Tipo

Ancho máximo

Descripción

Req.

acquirerId

Numérico

4

Código de adquirente proporcionado por la entidad afiliadora.

Si

idCommerce

Numérico

4

Código único de comercio proporcionado por la entidad afiliadora. Valor fijo.

Si

purchaseOperationNumber

Numérico

6

Identificador único por cada transacción, generado por el comercio. Considerar que deberán ser enviados los 6 caracteres obligatoriamente.

Si

purchaseAmount

Numérico

10

Valor total de la compra. (4)

Si

purchaseCurrencyCode

Numérico

3

Moneda según Estándar numérico ISO. Considerar las monedas habilitadas por la entidad afiliadora.

Soles: 604

Dólares: 840

Si

language

Alfanumérico

2

Idioma usado: español (SP), inglés (EN).

(Valor por defecto Español)

Si

billingFirstName

Alfanumérico

30

Nombre del tarjetahabiente. (como aparece en la tarjeta de crédito) (1).

No

billingLastName

Alfanumérico

50

Apellido del tarjetahabiente (como aparece en la tarjeta de crédito) (1).

No

billingEMail

Alfanumérico

50

Dirección electrónica del tarjetahabiente. (1).

No

billingAddress

Alfanumérico

50

Dirección del tarjetahabiente. (1).

No

billingZIP

Alfanumérico

10

Código Postal del tarjetahabiente.

No

billingCity

Alfanumérico

50

Nombre de la ciudad del tarjetahabiente. (1).

No

billingState

Alfanumérico

2

Primeros 2 caracteres del Estado, Departamento o Localidad del tarjetahabiente.

No

billingCountry

Alfanumérico

2

Código ISO del país del tarjetahabiente. (1).

No

billingPhone

Alfanumérico

15

Teléfono del tarjetahabiente.

No

shippingFirstName

Alfanumérico

30

Nombre de la persona que recibirá los bienes.

Si

shippingLastName

Alfanumérico

50

Apellido de la persona que recibirá los bienes.

Si

shippingEmail

Alfanumérico

50

Email de la persona que recibirá los bienes.

Si

shippingAddress

Alfanumérico

50

Dirección de entrega del pedido del tarjetahabiente.

Si

shippingZIP

Alfanumérico

10

Código Postal de la entrega.

Si

shippingCity

Alfanumérico

50

Nombre de la ciudad de entrega.

Si

shippingState

Alfanumérico

15

Nombre del estado/región o departamento de entrega.

Si

shippingCountry

Alfanumérico

2

Código ISO del país de entrega.

Si

shippingPhone

Alfanumérico

15

Teléfono del lugar de entrega.

No

shippingDNI

Alfanumérico

10

DNI de la persona que recibe los bienes.

No

HTTPSessionId

Alfanumérico

30

Sesión HTTP solo en el caso que el comercio lo requiera

No

terminalCode

Alfanumérico

12

Código de terminal de la compra

No

userCommerce

Alfanumérico

20

Código de usuario del tarjetahabiente en el comercio.  En Wallet el parámetro es codCardHolderCommerce. (3).

Si

userCodePayme

Alfanumérico

30

Código de asociación con Wallet para el usuario. En Wallet el parámetro es codAsoCardHolderWallet. (3)

Si

descriptionProducts

Alfanumérico

30

Descripción del producto ó servicio comprado por el tarjetahabiente. (1)

Si

programmingLanguage

Alfanumérico

15

Estipula el lenguaje de programación utilizado por el Comercio. Ejemplo: JAVA, PHP, VB.NET, PYTHON, RUBY, etc.

Si

purchaseVerification

Alfanumérico

(Longitud no fija).

Firma digital de la trama se solicitud de pago. Contiene el valor cifrado de los campos acquirerId, idCommerce, purchaseOperationNumber, purchaseAmount, purchaseCurrencyCode y la clave SHA-2 para la pasarela descargada del sistema V-Payment. (PASSWORD_COM_XXXX_PASARELA_XXXXXXXXXXXX.txt).

Si

reserved1 – reserved21

Alfanumérico

30

Campos para datos adicionales no contemplados en el V-POS2. (2)

No

reserved24 – reserved40

Alfanumérico

30

Campos para datos adicionales no contemplados en el V-POS2. (2)

No

*Consideraciones

(1)    Solo se permiten caracteres alfanuméricos.

(2)    Campos enviados por el comercio con información adicional. Estos serán devueltos con el mismo valor al momento de enviar la respuesta al comercio con el resultado del procesamiento de la transacción.

(3)    Campos requeridos para la integración con Wallet.

(4) Valor que debe cumplir con las consideraciones del formato monto. Debe ir sin separador decimal (Si el monto es 100.30 dólares entonces la cantidad a enviar es 10030).

Parámetros de Respuesta

A continuación, se detalla la lista de parámetros que el comercio recibirá de la solicitud de pago:

Campo

Tipo

Ancho máximo

Descripción

authorizationResult

Numérico

2

Este campo contiene el resultado de la autorización. Tiene tres posibles valores enviados por el V-POS:

00, indica que la transacción ha sido autorizada,

01, indica que la transacción ha sido denegada en el Banco Emisor, y

05, indica que la transacción ha sido rechazada por el V-POS.

NOTA IMPORTANTE: El comercio mostrará los mensajes de resultado al tarjetahabiente según estos tres códigos. Por ejemplo:

“Operación Autorizada”.

“Operación Denegada”.

“Operación Rechazada”

authorizationCode

Alfanumérico

6

En caso que la transacción haya sido autorizada por el Banco Emisor, este campo contendrá el código de autorización de la transacción.

errorCode

Alfanumérico

4

En caso que la transacción haya sido denegada o rechazada este campo contendrá el código de error respectivo que indicará el motivo del rechazo. La lista de códigos es dinámica y puede aumentar o disminuir según las mejoras que se realicen al V-POS y/o nuevas especificaciones de las marcas y procesadoras.

Este código de respuesta no debe ser mostrado al tarjetahabiente.

Revise la tabla de códigos de retorno

errorMessage

Alfanumérico

-

Este campo contendrá la descripción del código de error en caso de producirse un rechazo.

NOTA IMPORTANTE: Este mensaje de error no debe ser mostrado al tarjetahabiente. El Adquirente puede acordar con el comercio para que se muestren grupos de mensajes.

answerCode

Alfanumérico

-

Código de respuesta de la procesadora con la cual se efectúo el pago.

answerMessage

Alfanumérico

-

Mensaje de respuesta que describe el valor del campo answerCode.

bin

Alfanumérico

6

Este campo contiene los 6 primeros números de la tarjeta de pago, solamente es enviada en caso este valor se obtenga.

brand

Alfanumérico

12

Este campo contiene la descripción de la marca, puede darse los siguientes valores VISA, MC, AMEX o DN.

paymentReferenceCode

Alfanumérico

-

En caso la compra fue realizada con alguna marca de tarjeta, se devolverá el número de tarjeta enmascarada (ejemplo: 414243******1234). Para otros medios, se devolverá el código respectivo.

purchaseVerification

Alfanumérico

(Longitud no fija).

Firma generada utilizando el algoritmo de cifrado SHA-2 en base a los siguientes parámetros: acquirerId, idCommerce, purchaseOperationNumber, purchaseAmount, purchaseCurrencyCode, authorizationResult y la clave SHA-2 para la pasarela descargada del sistema V-Payment. (PASSWORD_COM_XXXX_PASARELA_XXXXXXXXXXXX.txt) El mismo será utilizado para la validación de los datos en el proceso de respuesta.

 

reserved1 – reserved21

Alfanumérico

30

Campos para datos adicionales no revisados por el V-POS2.

reserved22

Alfanumérico

30

Este campo retorna el tipo de tarjeta: DEBIT o CREDIT (el contenido es opcional y está sujeto a disponibilidad de la información).

reserved23

Alfanumérico

30

Este campo retorna el nombre del Banco Emisor de la Tarjeta utilizada en la transacción (el contenido es opcional y está sujeto a disponibilidad de la información).

reserved24 - reserved40

Alfanumérico

30

Campos para datos adicionales no revisados por el V-POS2.

IDTransaction

Alfanumérico

28

Id de la transacción generada por Alignet para la identificación por parte del comercio del pedido realizado con fines de trazabilidad

txDateTime

Alfanumérico

19

Este campo retorna la fecha y hora de registro de la transacción con el formato: DD/MM/AAAA HHMMSS: donde DD es día, MM es mes, AAAA es año, HH indica hora en formato de 24 horas, MM minutos y SS segundos.

Continuar a Notificaciones de Respuesta ➡️

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.