Transacción
Permite procesar transacciones con token o sin token con la posibilidad de tokenizar.
Parámetros en formato JSON en el cuerpo de la petición POST.
merchantId
sí
Alfanumérico
Nombre identificador del comercio.
order
sí
Alfanumérico
Identificación de la orden generada por el comercio. Es el número asignado por el comercio, no el número asignado por Payvalida.
checksum
sí
Alfanumérico
Checksum formado de la siguiente manera: SHA512(merchantId + order + fixed_hash)
cvv
sí
numérico
Código de seguridad de la tarjeta de crédito/débito. Este parámetro debe enviarse la primera vez que se hace una transacción con la tarjeta de crédito/débito, y es opcional enviarlo en caso de usar un token. Si se recibe el parámetro, se usará; en caso contrario se hará la transacción como recurrente.
fechaExpiracion
sí
Alfanumérico
Fecha de expiración de la tarjeta de crédito/débito en formato MM/AA. Este parámetro es requerido si la transacción no es mediante token; e ignorado si la transacción se hace con un token, en cuyo caso se usará la información almacenada correspondiente a la tarjeta del token.
cuotas
sí
numérico
Cantidad de cuotas en las que se realizará el pago. Este campo debe ser mayor o igual a 1.
di
sí
Alfanumérico
Número de documento de identificación de la persona que realiza la transacción.
token
no
Alfanumérico
Token de una tarjeta de crédito/débito. Usado cuando se quiere hacer uso de una tarjeta de crédito/débito previamente tokenizada (parámetro «tokenizar» de este mismo servicio).
numeroTarjeta
no
Alfanumérico
Número de la tarjeta de crédito/débito. Este parámetro es requerido si la transacción no es mediante token; e ignorado si la transacción se hace con un token, en cuyo caso se usará la información almacenada correspondiente a la tarjeta del token.
nombreTitular
no
Alfanumérico
Nombre del titular de la tarjeta de crédito/débito sin apellidos. Este parámetro es requerido si la transacción no es mediante token; e ignorado si la transacción se hace con un token, en cuyo caso se usará la información almacenada correspondiente a la tarjeta del token.
apellidosTitular
no
Alfanumérico
Apellidos del titular de la tarjeta de crédito/débito. Este parámetro es requerido si la transacción no es mediante token; e ignorado si la transacción se hace con un token, en cuyo caso se usará la información almacenada correspondiente a la tarjeta del token.
franquicia
no
Alfabético
Define la franquicia de la tarjeta de crédito/débito. Si se omite este campo y la transacción no es con token, se infiere la franquicia del número de la TC. Este campo es ignorado si la transacción se hace con un token, en cuyo caso se usará la información almacenada correspondiente a la tarjeta del token.
tokenizar
no
boolean
Indica si se quiere tokenizar la tarjeta de crédito/débito. Este parámetro es ignorado si la transacción se hace con un token.
correo
sí
Alfanumérico
Dirección de correo electrónico de la persona que realiza la transacción.
telefono
sí
Alfanumérico
Número telefónico de la persona que realiza la transacción.
ip
si
Alfanumérico
Dirección IP del dispositivo origen de la transacción, del usuario final.
line1
sí
Alfanumérico
Linea 1 asociada a la dirección de facturación del usuario.
line2
sí
Alfanumérico
Linea 2 asociada a la dirección de facturación del usuario.
line3
no
Alfanumérico
Linea 3 asociada a la dirección de facturación del usuario.
country
sí
Alfanumérico
Pais del usuario.
city
sí
Alfanumérico
Ciudad del usuario.
state
sí
Alfanumérico
Estado o departamento del usuario
postCode
sí
Alfanumérico
Código postal de usuario.
xid
no (solo para transacciones autenticadas previamente con 3DS)
Alfanumérico
Identificador único generado por el banco emisor de la tarjeta para representar la solicitud de autenticación 3D Secure. Este campo debe ser igual a 36. Más información https://www.emvco.com/emv-technologies/3-d-secure/
eci
no (solo para transacciones autenticadas previamente con 3D Secure)
Númerico
ECI (Electronic Commerce Indicator) Código de dos dígitos que devuelven las redes de procesamiento de tarjetas de crédito y los bancos emisores para notificar a un comerciante de comercio electrónico la autenticación del titular de la tarjeta y la situación del banco emisor del titular de la tarjeta en el marco de 3D Secure. Cada red de tarjetas de crédito tiene un tipo específico de marco ECI utilizado. Más información https://www.emvco.com/emv-technologies/3-d-secure/
cavv
no (solo para transacciones autenticadas previamente con 3D Secure)
Alfanumérico
CAVV(Cardholder Authentication Verification Value) Criptograma único generado para cada transacción autenticada 3D Secure y vinculado al importe de la transacción y al beneficiario. El CAVV se transmite al comerciante y se envía junto con la solicitud de autorización para demostrar que se ha producido la autenticación. Más información https://www.emvco.com/emv-technologies/3-d-secure/
protocolVersion
no (solo para transacciones autenticadas previamente con 3D Secure)
Númerico
Versión del protocolo 3D Secure que acepta el emisor. Más información https://www.emvco.com/emv-technologies/3-d-secure/
Advertencia: El contenido del parámetro token tiene prioridad sobre el resto de parámetros referentes a datos de tarjeta de crédito/débito; en caso que se envíe una transacción con token, los parámetros no asociados a token (franquicia, número de tarjeta, nombre del titular, apellido del titular) serán ignorados.
El código result == 200 indica que la transacción fue enviada al procesador del banco, pero no necesariamente indica que fue aprobada. Para verificar la correcta transacción se debe verificar el campo data.transaction.responseCode == "APROBADA" (ver ejemplo de Response arriba). En caso de que se tokenice, el token se obtiene de data.token (ver ejemplo de Response arriba). En caso de error recibirá la descripción del error en el campo error.
Última actualización
¿Te fue útil?