Introducción


La presente documentación corresponde a Line API Rest.

Aclaraciones generales aplicable para todas las modalidades de utilización de la API de Line:

  • Si bien en el procesamiento de pagos con tarjetas de crédito existen de forma independiente las operaciones de anulación y de devolución, esta complejidad queda del lado de Line. En todos los casos el método a invocar se denomina anulación; la API determinará si la misma será efectivamente una anulación o una devolución.
  • El método reverso permite revertir una operación para la cual no se obtuvo respuesta. Se aplica especialmente para aquellos casos en los que, por ejemplo, se solicita una autorización de una operación y a continuación ha ocurrido una falla de comunicación. En cualquiera de los posibles escenarios (operación o no aprobada por el emisor de la tarjeta; autorización que no llegó al proceso de autorización; etc.), la operación es revertida. Line resuelve automáticamente si no debe hacer nada, si debe hacer una anulación o si debe hacer una devolución.

URL Ambiente de Test


Propiedades del Header HTTP


Para poder consumir el servicio ofrecido por la API REST de Line, es necesario enviar los siguientes campos en el 'Header' HTTP.

Los campos se muestran y detallan en la tabla a continuación:

Nombre Descripción Valor ¿Mandatorio?
Content-Type El tipo MIME del contenido del cuerpo enviado. Por defecto JSON es Unicode UTF-8. No se debe configurar otro charset application/json Si
Authorization   ApiKey eb0872bebd934e1c94979f7476c68242 Si

SSL: versión del protocolo y cifrado


Con la entrada en vigencia de las restricciones de uso de SSL y TLS temprana en entornos PCI DSS este 30 de junio de 2018, es importante que los comercios y proveedores de servicio estén totalmente seguros de que las configuraciones de TLS se adaptan a los lineamientos que exige el estándar, dentro de los cuales se encuentra emplear exclusivamente el protocolo Transport Layer Security (TLS) versión 1.2.

Time Out de Transacción


El tiempo habitual de Timeout para una transacción es menor que 5 segundos. Sin embargo el valor por defecto es de 30 segundos.

Si el cliente opta por utilizar un valor de Timeout menor a 30 segundos, deberá anular las transacciones en estado "Autorizada" mediante el método Reverso, el cual debe ser invocado posteriormente a los 30 segundos del valor de Timeout por defecto.

Transacciones e-commerce y presenciales sin dispositivo de captura asociado


Para operaciones presenciales o e-commerce sin dispositivo de captura asociado

Los métodos para trabajar con Line necesitan recibir el token de seguridad en el Header Authorization: ApiKey {token}

Para el ambiente de Test el header de Autorizacion es Authorization: ApiKey eb0872bebd934e1c94979f7476c68242

API Description

GET api/v1/creditcard/autorizaciontx/{identificador}

Obtiene la autorización de una operación según un identificador.

POST api/v1/creditcard/autorizacion

Realiza las autorización de una operación.

POST api/v1/creditcard/anulacion/{identificador}

Realiza la anulación/devolución de una operación

POST api/v1/creditcard/anulacion/{identificador}/{importe}

Realiza la anulación/devolución parcial de una operación

POST api/v1/creditcard/reverso/{identificador}

Realiza el reverso de una operación.

GET api/v1/creditcard/emisores/{canalVenta}

Obtiene los emisores disponibles por canal de venta

GET api/v1/creditcard/emisores/{canalVenta}/{codigoEmisor}

Obtiene la información de un emisor

GET api/v1/creditcard/comercios

Obtiene los comercios de un cliente.

GET api/v1/creditcard/comercios/{canalVenta}/{numeroComercio}

Obtiene un comercio por canal de venta  y número de comercio

GET api/v1/creditcard/conexiones/estado

Obtiene el estado de conexiones.

GET api/v1/creditcard/conexiones/estado/{host}

Obtiene el estado de una conexión.

GET api/v1/creditcard/autorizaciontx/{identificador}

Obtiene las autorizaciones de una operación según un identificador.

Información Request

URI parámetros

Propiedad Descripción Tipo Información Adicional

Identificador

Identificador de la operación provista por el cliente. Único por cada operación. Por ejemplo: “2607E530-92CB-02EA-DC87-EE01436C4862”

String

Requerido

Ejemplo Estructura Request

GET api/v1/creditcard/autorizaciontx/2607E530-92CB-02EA-DC87-EE01436C4862

Información Response

Success: HttpResponse 200 TXAutorizacionDto
Bad Request: HttpResponse 400.
Internal Server Error: HttpResponse 500.
Model: TXAutorizacionDto

Propiedad Descripción Tipo Información Adicional

CodigoCliente

Identificador de la operación provista por el cliente. Único por cada operación.

string

Identificador

Identificador de la operación en Line API. Único por operación.

string

TipoOperación

Indica el tipo de operación.

string

“COMPRA”, “ANULACION”, “DEVOLUCION”, “ANULADEV”

Fecha

Fecha y hora en que se realizó la operación.

Date

CanalVenta

Canal de venta de la operación.

string

TerminalSistema

Identificación de la terminal de la operación.

string

TerminalTipo

Tipo de terminal

string

Estado

Estado de la operación

string

"AUTORIZADA", "ANULADA", "NOAUTORIZADA", "ERROR", "ERRORCONFIGURACION", "PENDIENTEANULACION"

Mensaje

"OK" o cualquier otro mensaje generado por la entidad que procesa las autorizaciones.

string

CodigoEmisor

Código del emisor con el que se realizó la operación.

string

Referencia

Información del cliente. Texto libre. Se visualiza en los reportes y en las descargas de información

string

Autorizaciones

Lista de autorizaciones

Collection of AutorizacionDto

Anulaciones

Lista de anulaciones

Collection of AutorizacionDto

POST api/v1/creditcard/autorizacion

Realiza las autorizaciones de una operación.

Información Request

Parámetros URI

No lleva parámetros

Post Body

Datos de la operación a autorizar.

SolicitudTXAutorizacionDto

Propiedad Descripción Tipo Información Adicional

IdentificadorCliente

Identificador de la operación provista por el cliente. Único por cada operación. Ejemplo: “B65528C6-1A47-C2D6-31EB-0CAD7A20CB6D”

string

Requerido

CanalVenta

Indica el canal de ventas: "PDV", "WEB". Debe respetarse las mayúsculas. Ejemplo: “PDV”

string

Requerido

TerminalSistema

Identificación de la terminal de la operación. Ejemplo: "TERM001".

string

Requerido

TerminalTipo

Indica el tipo de terminal: "FISICA", "VIRTUAL". Debe respetarse las mayúsculas. Ejemplo: “FISICA”

string

Requerido

CodigoEmisor

Código del emisor con el que se realizó la operación: "VISA", “ELECTRON”, "MASTER", "AMEX", "NARANJA", etc. Ejemplo: “ELECTRON”

string

Código del emisor con el que se realizó la operación: "VISA", “ELECTRON”, "MASTER", "AMEX", "NARANJA", etc. Ejemplo: “ELECTRON”

ModoIngreso

Modo de ingreso: "MANUAL", "BANDA", "WEB", "CHIP", "CONTACTLESS". Ejemplo: “MANUAL”

string

Requerido. Deben respetarse las mayúsculas.

Moneda

Identifica la moneda de la operación: ARS, U$S. Ejemplo: “ARS”

string

Requerido. Deben respetarse las mayúsculas.

NumeroTarjeta

Número de la tarjeta a procesar. Ejemplo:”4507990000001026”

string

Requerido. Sin espacios en blancos ni separadores.

FechaExpiracion

Fecha de expiración de la tarjeta. Ejemplo: “2312”

string

Requerido. Formato YYMM.

TrackI

Track I de la tarjeta. Ejemplo: “%B4507990000001026^LAPOS/HOMOLOG DUAL ^250320100000 00632000000?

string

TrackII

Track II de la tarjeta. Ejemplo:” 4507990000001026=25032016320000000000?”

string

CodigoSeguridad

Código de seguridad de la tarjeta. Ejemplo: “123”

string

TarjetaTipo

Tipo de tarjeta: "CREDITO" o "DEBITO". Ejemplo: “DEBITO”

string

TipoDocumento

Tipo de documento del titular de la tarjeta: "DNI", "PASAPORTE", "LE", "LC”. Ejemplo: “DNI”

string

DocumentoTitular

Número de documento del titular de la tarjeta. Ejemplo: “33123456”

string

NombreTitular

Nombre del titular como figura en la tarjeta. Ejemplo: “Dana Golden”

string

EmailTitular

Correo electrónico del titular de la tarjeta. Ejemplo:”dana.golden@sucorreo.com”

string

Referencia

Información del Cliente. Texto libre. Se visualiza en los reportes y en las descargas de información. Ejemplo: “SKU 7766353”

string

Detalle

Lista de detalles de las autorizaciones

Collection of SolicitudAutorizacionDto

Ejemplo Estructura Request

	
application/json, text/json
{
  "IdentificadorCliente": "B65528C6-1A47-C2D6-31EB-0CAD7A20CB6D",
  "CanalVenta": "PDV",
  "TerminalSistema": "TERM001",
  "TerminalTipo": "FISICA",
  "CodigoEmisor": "ELECTRON",
  "ModoIngreso": "MANUAL",
  "Moneda": "ARS",
  "NumeroTarjeta": "4507990000001026",
  "FechaExpiracion": "2312",
  "TrackI": "%B4507990000001026^LAPOS/HOMOLOG DUAL   ^250320100000        00632000000?”,
  "TrackII": "4507990000001026=25032016320000000000?”,
  "CodigoSeguridad": "123",
  "TarjetaTipo": "DEBITO",
  "TipoDocumento": "DNI",
  "DocumentoTitular": "33123456",
  "NombreTitular": "Dana Golden",
  "EmailTitular": "dana,golden@sucorreo.com",
  "Referencia": "SKU 7766353",
  “Detalle”: [
    {
      "NumeroComercio": "34567899",
      "Importe": 350.00,
      "Cuotas": 1,
      "IdentificadorCliente": "B65528C6-1A47-C2D6-31EB-0CAD7A20CB6D",
      "Referencia": "SKU 7766353"
    }  ]
}						
						

Información Response

Success: HttpResponse 200 TXAutorizacionDto
Bad Request: HttpResponse 400.
Internal Server Error: HttpResponse 500.
Model: RespuestaTXAutorizacionDto

Propiedad Descripción Tipo Información Adicional

Identificador

Identificador de la operación en Line API. Único por operación.

string

IdentificadorCliente

Identificador de la operación provista por el cliente. Único por cada operación.

string

Estado

Estado de la operación.

string

"AUTORIZADA", "ANULADA", "NOAUTORIZADA", "ERROR", "ERRORCONFIGURACION", "PENDIENTEANULACION"

CodigoError

Devuelve el código de error de la operación.

integer

Para el Estado “ERROR" siempre es -1. Para el Estado “AUTORIZADA" siempre es 0. Para el Estado “NOAUTORIZADA" devuelve el código ISO de error según el Host Autorizador (ver Anexo II: Códigos de Error Host Autorizador)

Mensaje

"OK" o cualquier otro mensaje generado por la entidad que procesa las autorizaciones.

string

MensajeFormato

"Transacción autorizada" o cualquier otro mensaje generado por la entidad que procesa las autorizaciones.

string

NumeroTarjeta

Número de la tarjeta a procesar.

string

Sin espacios en blancos ni separadores.

NumeroCuenta

Es el número de cuenta asociado a la tarjeta.

string

ModoIngreso

Modo de ingreso.

string

"MANUAL", "BANDA", "WEB", "CHIP", "CONTACTLESS"

Detalle

Detalle de las autorizaciones de la operación.

Collection of RespuestaAutorizacionDto

Comercios Agregadores: Ejemplo Estructura Request

Las solicitudes de autorización de comercios agregadores, incluyen en el cuerpo del requerimiento el bloque Agregador, el cual se detalla a continuación:

Propiedad Descripción Tipo Información Adicional

TipoDocumento

Tipo de documento del comercio; puede ser “CUIT”, “CUIL”, “DNI”:. Ejemplo: “DNI”

string

Requerido. Debe respetarse las mayúsculas.

NroDocumento

Indica el número de documento del comercio. Ejemplo: “99999999”

numérico

Requerido. Longitud máxima 11 dígitos.

Nombre

Nombre del comercio final. Ejemplo: "COMERCIO".

string

Requerido

CodigoActividad

Indica el código de actividad del comercio. Ejemplo: “4816”

numérico

Requerido. Provisto por los adquirentes de acuerdo a la actividad del comercio.

Dirección

Dirección del comercio. Por ejemplo: “AVENIDA 3333”

string

Requerido

NroPuerta

Numéro de puerta del comercio. Por ejemplo: 9845

string

Opcional

CodigoPostal

Código postal del comercio. Por ejemplo: “1942”

string

Opcional

Comprobante

Número de comprobante emitido por el comercio final. Por ejemplo:”100001132”

string

Opcional

ProductoVendido

Detalle del producto o servicio vendido por el comercio final. Por ejemplo: “PRODUCTO1”

string

Opcional

NombreFantasiaResumen

Nombre de fantasía del comercio final, tal como aparecerá en el resumen del tarjetahabiente. Por ejemplo:”CA*EJEMPLO1”

string

Requerido. El texto previo al * será provisto por los adquirentes. No deben utilizarse espacios en blanco

	
application/json, text/json
{
	"IdentificadorCliente": ""be55b280-4371-48c1-8348-0239073ca461"",
	"CanalVenta": "WEB",
	"TerminalSistema": "HOMOLOG01",
	"TerminalTipo": "VIRTUAL",
	"CodigoEmisor": "VISA",
	"ModoIngreso": "WEB",
	"Moneda": "ARS",
	"NumeroTarjeta": "4507990000001026",
	"FechaExpiracion": "2503",
	"CodigoSeguridad": "830",
	"TarjetaTipo": "CREDITO",
	"TipoDocumento": "DNI",
	"DocumentoTitular": "99999999",
	"NombreTitular": "Dana Golden",
	"EmailTitular": "dana.golden@sumail.com.ar",
	"Referencia": "CASO-01",
	“Detalle”: [
	{
		"NumeroComercio": "03659364",
		"Importe": 101,
		"Cuotas": 1,
		"IdentificadorCliente": "be55b280-4371-48c1-8348-0239073ca461",
		"Referencia": "CASO-01"
		"Agregador": {
			"Comercio": {
				"TipoDocumento": "CUIT"	
				"NumeroDocumento": "20222222223"	
				"Nombre": "COMERCIO"
				"CodigoActividad": "4816"
				"Domicilio": {
					"Direccion": "AVENIDA 3333"
					"NroPuerta": "9845"
					"CodigoPostal": "1942"
				}
			},
			"Comprobante": "100001132"
			"ProductoVendido": "PRODUCTO1"
			"NombreFantasiaResumen": "CA*EJEMPLO"
			}
		}
	]
}						
						

Comercios Agregadores Información Response

Success: HttpResponse 200 TXAutorizacionDto
Bad Request: HttpResponse 400.
Internal Server Error: HttpResponse 500.

	
{
	"Identificador": "0001448462",
	"IdentificadorCliente": "be55b280-4371-48c1-8348-0239073ca461",
	"IdentificadorClienteOriginal": null,
	"Estado": "AUTORIZADA",
	"CodigoError": 0,
	"Mensaje": "OK",
	"MensajeFormato": "Transacción autorizada",
	"NumeroTarjeta": "450799******1026",
	"NumeroCuenta": "12345678",\
	"ModoIngreso": "WEB",
	"CodigoEstado": "approved",
	“Detalle”: [
	{
		"IdentificadorCliente": "2de8c1af-7114-4754-8724-be42586d55c0",
		"IdentificadorClienteOriginal": "",
		"NumeroTarjeta": null
		"NumeroCuenta": null
		"Fecha": "2021-02-24T17:44:42",
		"Terminal": "72029001",
		"Lote": "103",
		"Cupon": "1071",
		"PlanCuotas": "0",
		"Cuotas": "1",
		"CodigoAutorizacion": "040514",
		"Estado": "AUTORIZADA",
		"TipoOperacion": "COMPRA",
		"CodigoError": 0,
		"CodigoEstado": "approved",
		}
	]
}						
						

POST api/v1/creditcard/anulacion/{identificador}

Realiza la anulación/devolución de una operación.

Información Request

Parámetros URI

Propiedad Descripción Tipo Información Adicional

identificador

Identificador de la operación provista por el cliente. Único por cada operación. Ejemplo: “347bc7d7-6854-44b9-aec3-4a947fac71bf”

string

Requerido

Post Body

No lleva parámetros

Ejemplo Estructura Request

POST api/v1/creditcard/anulacion/347bc7d7-6854-44b9-aec3-4a947fac71bf

Información Response

Success: HttpResponse 200 TXAutorizacionDto
Bad Request: HttpResponse 400.
Internal Server Error: HttpResponse 500.
Model: RespuestaTXAutorizacionDto

Propiedad Descripción Tipo Información Adicional

Identificador

Identificador de la operación en Line API. Único por operación.

string

IdentificadorCliente

Identificador de la operación provista por el cliente. Único por cada operación.

string

Estado

Estado de la operación.

string

"AUTORIZADA", "ANULADA", "NOAUTORIZADA", "ERROR", "ERRORCONFIGURACION", "PENDIENTEANULACION".

CodigoError

Devuelve el código de error de la operación.

integer

Para el Estado “ERROR" siempre es -1. Para el Estado “AUTORIZADA" siempre es 0. Para el Estado “NOAUTORIZADA" devuelve el código ISO de error según el Host Autorizador. (ver Anexo II: Códigos de Error Host Autorizador)

Mensaje

"OK" o cualquier otro mensaje generado por la entidad que procesa las autorizaciones.

string

MensajeFormato

"Transacción autorizada" o cualquier otro mensaje generado por la entidad que procesa las autorizaciones.

string

NumeroTarjeta

Número de la tarjeta a procesar. Sin espacios en blancos ni separadores.

string

NumeroCuenta

Número de cuenta asociada a la tarjeta.

string

ModoIngreso

Modo de ingreso.

string

Detalle

Detalle de las autorizaciones de la operación.

Collection of RespuestaAutorizacionDto

POST api/v1/creditcard/anulacion/{identificador}/{importe}

Realiza la anulación/devolución parcial de una operación.

Información Request

Parámetros URI

Propiedad Descripción Tipo Información Adicional

identificador

Identificador de la operación provista por el cliente. Único por cada operación. Ejemplo: “458bc8d7-6854-66b9-bfd4-4a058fac82bf”

string

Requerido

importe

Importe a devolver/anular. Ejemplo: 2765.20

decimal number

Requerido. Sin separador de miles. El punto (“.”) es el separador decimal.

Post Body

No lleva parámetros

Ejemplo Estructura Request

POST api/v1/creditcard/anulacion/458bc8d7-6854-66b9-bfd4-4a058fac82bf/2765.20

Información Response

Success: HttpResponse 200 RespuestaTXAutorizacionDto
Bad Request: HttpResponse 400.
Internal Server Error: HttpResponse 500.
Model: RespuestaTXAutorizacionDto

Propiedad Descripción Tipo Información Adicional

Identificador

Identificador de la operación en Line API. Único por operación.

string

IdentificadorCliente

Identificador de la operación provista por el cliente. Único por cada operación.

string

Estado

Estado de la operación.

string

"AUTORIZADA", "ANULADA", "NOAUTORIZADA", "ERROR", "ERRORCONFIGURACION", "PENDIENTEANULACION"

CodigoError

Devuelve el código de error de la operación.

integer

Para el Estado “ERROR" siempre es -1. Para el Estado “AUTORIZADA" siempre es 0. Para el Estado “NOAUTORIZADA" devuelve el código ISO de error según el Host Autorizador. (ver Anexo II: Códigos de Error Host Autorizador)

Mensaje

"OK" o cualquier otro mensaje generado por la entidad que procesa las autorizaciones.

string

MensajeFormato

"Transacción autorizada" o cualquier otro mensaje generado por la entidad que procesa las autorizaciones.

string

NumeroTarjeta

Número de la tarjeta a procesar.

string

Sin espacios en blancos ni separadores.

NumeroCuenta

Número de cuenta asociada a la tarjeta.

string

ModoIngreso

Modo de ingreso.

string

"MANUAL", "BANDA", "WEB", "CHIP", "CONTACTLESS"

Detalle

Detalle de las autorizaciones de la operación.

Collection of RespuestaAutorizacionDto

POST api/v1/creditcard/reverso/{identificador}

Realiza el reverso de una operación.

Información Request

Parámetros URI

Propiedad Descripción Tipo Información Adicional

identificador

Identificador de la operación provista por el cliente. Único por cada operación. Ejemplo: “458bc8d7-6854-66b9-bfd4-4a058fac82bf”

string

Requerido

Body Post

No lleva parámetros

Ejemplo Estructura Request

POST api/v1/creditcard/reverso/458bc8d7-6854-66b9-bfd4-4a058fac82bf

Información Response

Success: HttpResponse 200 RespuestaTXAutorizacionDto
Bad Request: HttpResponse 400.
Internal Server Error: HttpResponse 500.
Model: RespuestaTXAutorizacionDto

Propiedad Descripción Tipo Información Adicional

Identificador

Identificador de la operación en Line API. Único por operación.

string

IdentificadorCliente

Identificador de la operación provista por el cliente. Único por cada operación.

string

Estado

Estado de la operación.

string

"AUTORIZADA", "ANULADA", "NOAUTORIZADA", "ERROR", "ERRORCONFIGURACION", "PENDIENTEANULACION"

CodigoError

Devuelve el código de error de la operación.

integer

Para el Estado “ERROR" siempre es -1. Para el Estado “AUTORIZADA" siempre es 0. Para el Estado “NOAUTORIZADA" devuelve el código ISO de error según el Host Autorizador. (ver Anexo II: Códigos de Error Host Autorizador)

Mensaje

"OK" o cualquier otro mensaje generado por la entidad que procesa las autorizaciones.

string

MensajeFormato

"Transacción autorizada" o cualquier otro mensaje generado por la entidad que procesa las autorizaciones.

string

NumeroTarjeta

Número de la tarjeta a procesar.

string

Sin espacios en blancos ni separadores.

NumeroCuenta

Número de cuenta asociada a la tarjeta.

string

ModoIngreso

Modo de ingreso.

string

"MANUAL", "BANDA", "WEB", "CHIP", "CONTACTLESS"

Detalle

Detalle de las autorizaciones de la operación.

Collection of RespuestaAutorizacionDto

GET api/v1/creditcard/emisores/{canalVenta}

Obtiene los emisores disponibles por canal de venta.

Información Request

Parámetros URI

Propiedad Descripción Tipo Información Adicional

canalVenta

Indica el canal de ventas: "PDV", "WEB". Ejemplo: “PDV”

string

Requerido. Debe respetarse las mayúsculas.

Ejemplo Estructura Request

GET api/v1/creditcard/emisores/PDV

Información Response

Success: HttpResponse 200 List EmisorDto
Bad Request: HttpResponse 400.
Internal Server Error: HttpResponse 500.
Model: Collection of EmisorDto

Propiedad Descripción Tipo Información Adicional

Código

Código del Emisor.

string

CvcSize

Longitud del CVC de la tarjeta.

integer

Retorna 0 si no tiene CVC.

DevolucionOnline

Indica si permite devolución online.

boolean

FormatoTarjeta

Formato de la tarjeta según el emisor.

string

HasCVC

Indica si el tipo de tarjeta del emisor tienen CVC.

boolean

HasExpirationDate

Indica si el tipo de tarjeta del emisor tienen fecha de expiración.

boolean

Nombre

Nombre del emisor.

string

Prioridad

Prioridad del tipo de tarjeta según el emisor.

integer

Orden descendente, de más específica a más genérica. Ejemplo: "VisaRio prioridad 2", "Visa prioridad 1".

Rango

Expresión regular del formato del número de la tarjeta.

string

ValidateLuhnCheck

Indica si se debe realizar la validación del Luhn (Algoritmo de módulo 10).

boolean

ImagenUrl

URL de la imagen del emisor.

string

CodigoEntidad

Código de la entidad de la tarjeta.

string

TarjetaTipo

Tipo de tarjeta.

string

GET api/v1/creditcard/emisores/{canalVenta}/{codigoEmisor}

Obtiene la información de un emisor.
Los métodos para trabajar con Line necesitan recibir el token de seguridad en el Header Authorization: ApiKey {token}
Para el ambiente de Test el header de Autorizacion es Authorization: ApiKey eb0872bebd934e1c94979f7476c68242

Información Request

Parámetros URI

Propiedad Descripción Tipo Información Adicional

canalVenta

Indica el canal de ventas: "PDV", "WEB". Ejemplo: “PDV”

string

Requerido. Debe respetarse las mayúsculas.

codigoEmisor

Código del emisor con el que se realizó la operación: "VISA", “ELECTRON”, "MASTER", "AMEX", "NARANJA", etc. Ejemplo: “VISA”

string

Requerido. Deben respetarse las mayúsculas. Consulte el Anexo I: Códigos de Emisores.

Ejemplo Estructura Request

GET api/v2/creditcard/emisores/PDV/VISA

Información Response

Success: HttpResponse 200 EmisorDto
Bad Request: HttpResponse 400.
Internal Server Error: HttpResponse 500.
Model: EmisorDto

Propiedad Descripción Tipo Información Adicional

Código

Código del Emisor.

string

CvcSize

Longitud del CVC de la tarjeta.

integer

Retorna 0 si no tiene CVC.

DevolucionOnline

Indica si permite devolución online.

boolean

FormatoTarjeta

Formato de la tarjeta según el emisor.

string

HasCVC

Indica si el tipo de tarjeta del emisor tienen CVC.

boolean

HasExpirationDate

Indica si el tipo de tarjeta del emisor tienen fecha de expiración.

boolean

Nombre

Nombre del emisor.

string

Prioridad

Prioridad del tipo de tarjeta según el emisor.

integer

Orden descendente, de más específica a más genérica. Ejemplo: "VisaRio prioridad 2", "Visa prioridad 1".

Rango

Expresión regular del formato del número de la tarjeta.

string

ValidateLuhnCheck

Indica si se debe realizar la validación del Luhn (Algoritmo de módulo 10).

boolean

ImagenUrl

URL de la imagen del emisor.

string

CodigoEntidad

Código de la entidad de la tarjeta.

string

TarjetaTipo

Tipo de tarjeta.

string

GET api/v1/creditcard/comercios

Obtiene los comercios de un cliente.
Los métodos para trabajar con Line necesitan recibir el token de seguridad en el Header Authorization: ApiKey {token}
Para el ambiente de Test el header de Autorizacion es Authorization: ApiKey eb0872bebd934e1c94979f7476c68242

Información Request

Parámetros URI

No lleva parámetros.

Ejemplo Estructura Request

GET api/v2/creditcard/comercios

Información Response

Success: HttpResponse 200 ComercioDto
Bad Request: HttpResponse 400.
Internal Server Error: HttpResponse 500.
Model: Collection of ComercioDto

Propiedad Descripción Tipo Información Adicional

CanalVenta

Canal de venta.

string

NumeroComercio

Número de comercio.

string

Descripcion

Descripción del comercio.

string

HostAutorizador

Host autorizador.

string

CodigoEntidad

Código de entidad.

string

RazonSocial

Razón social del comercio.

string

CUIT

CUIT del comercio.

string

NombreFantasia

Nombre de fantasía del comercio.

string

GET api/v1/creditcard/comercios/{canalVenta}/{numeroComercio}

Obtiene un comercio por canal de venta y número de comercio.
Los métodos para trabajar con Line necesitan recibir el token de seguridad en el Header Authorization: ApiKey {token}
Para el ambiente de Test el header de Autorizacion es Authorization: ApiKey eb0872bebd934e1c94979f7476c68242

Información Request

Parámetros URI

Propiedad Descripción Tipo Información Adicional

CanalVenta

Indica el canal de ventas: "PDV", "WEB". Ejemplo: “WEB”

string

Requerido. Debe respetarse las mayúsculas.

NumeroComercio

Número de comercio. Ejemplo:"10666292"

string

Requerido

Ejemplo Estructura Request

GET api/v1/creditcard/comercios/WEB/10666292

Información Response

Success: HttpResponse 200 ComercioDto
Bad Request: HttpResponse 400.
Internal Server Error: HttpResponse 500.
Model: ComercioDto

Propiedad Descripción Tipo Información Adicional

CanalVenta

Canal de venta.

string

NumeroComercio

Número de comercio.

string

Descripcion

Descripción del comercio.

string

HostAutorizador

Host autorizador.

string

CodigoEntidad

Código de entidad.

string

RazonSocial

Razón social del comercio.

string

CUIT

CUIT del comercio.

string

NombreFantasia

Nombre de fantasía del comercio.

string

GET api/v1/creditcard/conexiones/estado

Obtiene el estado de las conexiones.

Información Request

Parámetros URI

No lleva parámetros

Ejemplo Estructura Request

GET api/v1/creditcard/conexiones/estado

Información Response

Success: HttpResponse 200 List ConexionHostDto
Bad Request: HttpResponse 400.
Internal Server Error: HttpResponse 500.
Model: Collection of ConexionHostDto

Propiedad Descripción Tipo Información Adicional

Host

Host.

string

Estado

Estado del Host.

string

FechaUltimaVerificacion

Fecha y hora en que se realizó la última verificación del estado del Host.

date

GET api/v1/creditcard/conexiones/estado/{host}

Obtiene el estado de una conexión en particular.

Información Request

Parámetros URI

Propiedad Descripción Tipo Información Adicional

host

Identificación del Host cuyo estado se desea consultar. Ejemplo:”AMEX”

string

Requerido. Debe respetarse las mayúsculas. AMEX, PRISMAVISA, PRISMAMASTER,FIRSTDATA1, FIRSTDATACAL

Ejemplo Estructura Request

GET api/v1/creditcard/conexiones/estado/AMEX

Información Response

Success: HttpResponse 200 ConexionHostDto
Bad Request: HttpResponse 400.
Internal Server Error: HttpResponse 500.
Model: ConexionHostDto

Propiedad Descripción Tipo Información Adicional

Host

Host.

string

Estado

Estado del Host.

string

FechaUltimaVerificacion

Fecha y hora en que se realizó la última verificación del estado del Host.

date

Transacciones Presenciales con Dispositivo de Captura


Para operaciones presenciales utilizando dispositivo de captura Pin Pad, para tarjetas con banda magnética, chip y contactless.

Los métodos para trabajar con Line necesitan recibir el token de seguridad en el Header Authorization: ApiKey {token}

Para el ambiente de Test el header de Autorizacion es Authorization: ApiKey eb0872bebd934e1c94979f7476c68242

API Description

GET api/v2/presente/autorizaciontx/{identificador}

Obtiene las autorizaciones de una operación según un identificador.

POST api/v2/presente/autorizacion

Realiza las autorizaciones de una operación.

POST api/v2/presente/anulacion

Realiza la anulación/devolución de una operación

POST api/v2/presente/reverso

Realiza el reverso de una operación.

GET api/v2/presente/emisores/{canalVenta}

Obtiene los emisores disponibles por canal de venta

GET api/v2/presente/emisores/{canalVenta}/{codigoEmisor}

Obtiene la información de un emisor

GET api/v2/presente/comercios

Obtiene los comercios de un cliente.

GET api/v2/presente/comercios/{canalVenta}/{numeroComercio}

Obtiene un comercio por canal de venta y número de comercio

GET api/v2/presente/conexiones/estado

Obtiene el estado de conexiones.

GET api/v2/presente/conexiones/estado/{host}

Obtiene el estado de una conexión.

GET api/v2/presente/autorizaciontx/{identificador}

Obtiene las autorizaciones de una operación según un identificador.
Los métodos para trabajar con Line necesitan recibir el token de seguridad en el Header Authorization: ApiKey {token}
Para el ambiente de Test el header de Autorizacion es Authorization: ApiKey eb0872bebd934e1c94979f7476c68242

Información Request

Parámetros URI

Propiedad Descripción Tipo Información Adicional

identificador

Identificador de la operación provista por el cliente. Único por cada operación. Ejemplo: “458bc8d7-6854-66b9-bfd4-4a058fac82bf”

string

Requerido.

Ejemplo Estructura Request

GET api/v2/presente/autorizaciontx/458bc8d7-6854-66b9-bfd4-4a058fac82bf

Información Response

Success: HttpResponse 200 TXAutorizacionDto
Bad Request: HttpResponse 400.
Internal Server Error: HttpResponse 500.
Model: TXAutorizacionDto

Propiedad Descripción Tipo Información Adicional

CodigoCliente

Identificador de la operación provista por el cliente. Único por cada operación.

string

Identificador

Identificador de la operación en Line API. Único por operación.

string

TipoOperacion

Indica el tipo de operación.

string

“COMPRA”, “ANULACION”, “DEVOLUCION”, “ANULADEV”

Fecha

Fecha y hora en que se realizó la operación.

date

CanalVenta

Canal de venta de la operación.

string

“PDV”, “WEB”

TerminalSistema

Identificación de la terminal de la operación.

string

TerminalTipo

Tipo de Terminal

string

"FISICA", "VIRTUAL"

Estado

Estado de la operación.

string

"AUTORIZADA", "ANULADA", "NOAUTORIZADA", "ERROR", "ERRORCONFIGURACION", "PENDIENTEANULACION"

Mensaje

"OK" o cualquier otro mensaje generado por la entidad que procesa las autorizaciones.

string

CodigoEmisor

Código del emisor con el que se realizó la operación.

string

"VISA", “ELECTRON”, "MASTER", "AMEX", "NARANJA", etc. Consulte el Anexo I: Códigos de Emisores.

Referencia

Información del cliente. Texto libre. Se visualiza en los reportes y en las descargas de información.

string

Autorizaciones

Lista de autorizaciones

Collection of AutorizacionDto

Anulaciones

Lista de anulaciones

Collection of AutorizacionDto

POST api/v2/presente/autorizacion

Realiza la autorización de una operación.
Los métodos para trabajar con Line necesitan recibir el token de seguridad en el Header Authorization: ApiKey {token}
Para el ambiente de Test el header de Autorizacion es Authorization: ApiKey eb0872bebd934e1c94979f7476c68242

Información Request

Parámetros URI

No lleva parámetros.

Post Body

Datos de la operación a autorizar.

SolicitudTXPresenteDto

Propiedad Descripción Tipo Información Adicional

IdentificadorCliente

Identificador de la operación provista por el cliente. Único por cada operación. Ejemplo:”TEST-PINPAD-22286”

string

Referencia

Información del cliente. Texto libre. Se visualiza en los reportes y en las descargas de información. Ejemplo: “22286”

string

Tarjeta

Agrupador de los datos de la tarjeta.

TarjetaPresenteDto

TerminalCaptura

Información del Pin Pad de captura.

TerminalCapturaDto

Si no utiliza Pin Pad no aplica.

TerminalSistema

Lista de detalles de las autorizaciones.

string

CodigoEmisor

Código del emisor con el que se realizó la operación. "VISA", “ELECTRON”, "MASTER", "AMEX", "NARANJA", etc. Ejemplo: “VISA”.

string

Deben respetarse las mayúsculas. Consulte el Anexo I: Códigos de Emisores.

Moneda

Identifica la moneda de la operación: ARS, U$S. Ejemplo: “ARS”

string

Deben respetarse las mayúsculas.

NumeroComercio

Número de comercio. Ejemplo: “03659307

string

Importe

Importe a debitar. Ejemplo: 224.00

decimal number

Sin separador de miles. El punto (“.”) es el separador decimal.

Cuotas

Cantidad de cuotas. Ejemplo: 1

integer

Detalle

Detalle de la apertura de la operación en múltiples comercios.

Collection of SolicitudDetallePresenteDto

Ejemplo Estructura Request Modo de Ingreso CHIP

	
application/json, text/json
{
  "IdentificadorCliente": "TEST-PINPAD-22286",
  "Referencia": "22286",
  "Tarjeta": {
	  "ModoIngreso": "CHIP",
	  "NumeroTarjeta": "44278000****0304",
	  "SecuenciaTarjeta": "001",
	  "FechaExpiracion": "2212",
	  "TrackI": "",
	  "TrackII": "%4427800001020304=22122011790663689;",
	  "CodigoSeguridad": null,
	  "NombreTitular": "VISA ACQUIRER TEST/CARD 24",
	  "PaqueteEncriptado": null,
	  "CriptogramaEMV": "82021C009F2608CC81E9F6EBBFB1279F2701809F360200019F100706010A03A410009F1E083137393939393931950580800080009F3303E0F8C89F34034103029F3704D7442CB55F25030907019A032006259F02060000000224009F03060000000000009C01008408A000000003101001",
	  "PINBlock": "",
	  "TarjetaTipo": "CREDITO",
	  "TipoCuenta": "",
	  "EsFallBack": false,	  
  }
    "TerminalCaptura": {
	  "NroSerieFisico": "900-438-211",
	  "NroSerieLogico": "",
	  "Encripta": false,
	  "TipoEncripcion": "N",
	  "VersionSoft": "0319B15",
  }
      "TerminalSistema": "TER1"
	  "CodigoEmisor": "VISA",
	  "Moneda": "ARS",
	  "NumeroComercio": "03659307",
	  "Importe": 224.00,
	  "Cuotas": 1,
	  "Detalle": [],	  
  }
						

Ejemplo Estructura Request Modo de Ingreso CONTACTLESS

	
application/json, text/json
{
  "IdentificadorCliente": "TEST-PINPAD-38034",
  "Referencia": "38034",
  "Tarjeta": {
	  "ModoIngreso": "CONTACTLESS",
	  "NumeroTarjeta": "45079900****1026",
	  "SecuenciaTarjeta": "000",
	  "FechaExpiracion": "2503",
	  "TrackI": "",
	  "TrackII": "%4507990000001026=25032019080000000000;",
	  "CodigoSeguridad": "",
	  "NombreTitular": "PAYWAVE/VISA",
	  "PaqueteEncriptado": null,
	  "CriptogramaEMV": "82022000950500000000009A032007069C01009F02060000000031009F03060000000000009F100706010A03A028009F2608EEC2CCCDB1346F3F9F2701809F3303E0F8C89F34030000009F360200159F370482F6AB429F1E0831313138383932359F6E04207000008407A0000000031010",
	  "PINBlock": "",
	  "TarjetaTipo": "CREDITO",
	  "TipoCuenta": "",
	  "EsFallBack": true,	  
  }
    "TerminalCaptura": {
	  "NroSerieFisico": "192647313011108511188925",
	  "NroSerieLogico": "",
	  "Encripta": false,
	  "TipoEncripcion": "N",
	  "VersionSoft": "0313B27",
  }
      "TerminalSistema": "TER1"
	  "CodigoEmisor": "VISA",
	  "Moneda": "ARS",
	  "NumeroComercio": "03659307",
	  "Importe": 31.00,
	  "Cuotas": 1,
	  "Detalle": [],	  
  }
						

Ejemplo Estructura Request Modo de Ingreso BANDA

	
application/json, text/json
{
  "IdentificadorCliente": "TEST-PINPAD-10663",
  "Referencia": "10663",
  "Tarjeta": {
	  "ModoIngreso": "BANDA",
	  "NumeroTarjeta": "45079900****1026",
	  "SecuenciaTarjeta": null,
	  "FechaExpiracion": "2503",
	  "TrackI": "%B4507990000001026^LAPOS/HOMOLOG DUAL   ^250320100000        00632000000;",
	  "TrackII": "%4507990000001026=25032016320000000000;",
	  "CodigoSeguridad": "830",
	  "NombreTitular": "LAPOS/HOMOLOG DUAL",
	  "PaqueteEncriptado": null,
	  "CriptogramaEMV": null,
	  "PINBlock": "",
	  "TarjetaTipo": "CREDITO",
	  "TipoCuenta": "",
	  "EsFallBack": true,	  
  }
    "TerminalCaptura": {
	  "NroSerieFisico": "900-438-211",
	  "NroSerieLogico": null,
	  "Encripta": false,
	  "TipoEncripcion": "N",
	  "VersionSoft": "0319B15",
  }
      "TerminalSistema": "TER1"
	  "CodigoEmisor": "VISA",
	  "Moneda": "ARS",
	  "NumeroComercio": "03659307",
	  "Importe": 208.0,
	  "Cuotas": 1,
	  "Detalle": [],	  
  }
						

Información Response

Success: HttpResponse 200 RespuestaTXAutorizacionDto
Bad Request: HttpResponse 400.
Internal Server Error: HttpResponse 500.
Model: RespuestaTXPresenteDto

Propiedad Descripción Tipo Información Adicional

TipoOperacion

Indica el tipo de operación.

string

“COMPRA”, “ANULACION”, “DEVOLUCION”, “ANULADEV”

Fecha

Fecha de la operación.

date

Identificador

Identificador de la operación en Lne API. Único por operación.

string

IdentificadorCliente

Identificador de la operación provista por el cliente. Único por cada operación.

string

Estado

Estado de la operación.

string

"AUTORIZADA", "ANULADA", "NOAUTORIZADA", "ERROR", "ERRORCONFIGURACION", "PENDIENTEANULACION"

CodigoError

Devuelve el código de error de la operación.

integer

Para el Estado “ERROR" siempre es -1. Para el Estado “AUTORIZADA" siempre es 0. Para el Estado “NOAUTORIZADA" devuelve el código ISO de error según el Host Autorizador (ver Anexo II: Códigos de Error Host Autorizador)

Mensaje

"OK" o cualquier otro mensaje generado por la entidad que procesa las autorizaciones.

string

MensajeFormato

"Transacción autorizada" o cualquier otro mensaje generado por la entidad que procesa las autorizaciones.

string

NumeroTarjeta

Número de la tarjeta.

string

NumeroCuenta

Número de cuenta asociada a la tarjeta

string

ModoIngreso

Modo de Ingreso

string

"MANUAL", "BANDA", "CHIP", "CONTACTLESS".

Terminal

Identificador de la terminal

string

Lote

Número de lote generado por la entidad que procesa las autorizaciones.

integer

Cupon

Número de cupón generado por la entidad que procesa las autorizaciones.

integer

CodigoAutorizacion

Código de autorización generado por la entidad que procesa las autorizaciones. Sólo se genera para las operaciones autorizadas.

string

CriptogramaEMVRespuesta

Es el criptograma de seguridad de PIN PAD que confirma la operación.

string

CodigoRespuesta

Devuelve el código de respuesta.

string

Detalle

Detalle de las autorizaciones de la operación.

Collection of RespuestaDetallePresenteDto

POST api/v2/presente/anulacion

Realiza la anulación/devolución de una operación.
Los métodos para trabajar con Line necesitan recibir el token de seguridad en el Header Authorization: ApiKey {token}
Para el ambiente de Test el header de Autorizacion es Authorization: ApiKey eb0872bebd934e1c94979f7476c68242

Información Request

Parámetros URI

No lleva parámetros.

Post Body

AnulacionTXPresenteDto

Propiedad Descripción Tipo Información Adicional

IdentificadorCliente

Identificador de la operación provista por el cliente. Único por cada operación. Ejemplo: “1984TLK33U”

string

Tarjeta

Agrupador de los datos de la tarjeta

TarjetaPresenteDto

TerminalCaptura

Información del Pin Pad de captura.

TarjetaPresenteDto

Si no utiliza Pin Pad no aplica

TerminalSistema

Lista de detalles de las autorizaciones.

string

ModoIngreso

Modo de ingreso: "MANUAL", "BANDA", "CHIP", "CONTACTLESS". Ejemplo: “BANDA”.

string

EsFallBack

Indica si falló o no la lectura del chip.

boolean

En caso de fallo (true) habilita lectura por banda magnética.

Importe

Importe a debitar. Ejemplo: 1050.30

decimal number

Sin separador de miles. El punto (“.”) es el separador decimal.

Detalle

Detalle de la apertura de la operación en múltiples comercios.

Collection of AnulacionDetallePresenteDto

Ejemplo Estructura Request Modo de Ingreso CHIP

	
application/json, text/json
{
  "IdentificadorCliente": "TEST-PINPAD-55101",
  "Tarjeta": {
	  "ModoIngreso": "CHIP",
	  "NumeroTarjeta": "53005890****1717",
	  "SecuenciaTarjeta": "000",
	  "FechaExpiracion": "2105",
	  "TrackI": "",
	  "TrackII": "%5300589000831717=21052010000071300008;",
	  "CodigoSeguridad": null,
	  "NombreTitular": "SISTEMA/PROPIO",
	  "PaqueteEncriptado": null,
	  "CriptogramaEMV": "820239009F26087F0556E3B0BB1BCF9F2701809F360200099F10120110A04003220000000000000000000000FF9F1E083137393939393931950500000080009F3303E0F8C89F34031E03009F37043F2CF9AC5F25032006059A032006149F02060000000013009F03060000000000009C01028407A0000000041010",
	  "PINBlock": "",
	  "TarjetaTipo": "CREDITO",
	  "TipoCuenta": "", 
  }
    "TerminalCaptura": {
	  "NroSerieFisico": "900-438-211",
	  "NroSerieLogico": "",
	  "Encripta": false,
	  "TipoEncripcion": "N",
	  "VersionSoft": "0319B15",
  }
      "TerminalSistema": "ANU01"
	  "Importe": 13.00,
	  "Detalle": [],	  
  }
						

Ejemplo Estructura Request Modo de Ingreso CONTACTLESS

	
application/json, text/json
{
  "IdentificadorCliente": "TEST-PINPAD-22856",
  "Tarjeta": {
	  "ModoIngreso": "CONTACTLESS",
	  "NumeroTarjeta": "53005890****1709",
	  "SecuenciaTarjeta": "000",
	  "FechaExpiracion": "2105",
	  "TrackI": "",
	  "TrackII": "%5300589000831709=21052010000084500008;",
	  "CodigoSeguridad": "",
	  "NombreTitular": "",
	  "PaqueteEncriptado": null,
	  "CriptogramaEMV": "5F250320060582021980950500000080019A032006179C01009F02060000000012009F03060000000000009F10120110A04003220000000000000000000000FF9F260890BD9B9D50F22A059F2701809F33030008089F34031F03029F360200079F37040AB774759F1E0831323334353637389F6E0700320000303000",
	  "PINBlock": "",
	  "TarjetaTipo": "CREDITO",
	  "TipoCuenta": "", 
  }
    "TerminalCaptura": {
	  "NroSerieFisico": "900-438-211",
	  "NroSerieLogico": "",
	  "Encripta": false,
	  "TipoEncripcion": "N",
	  "VersionSoft": "0319B15",
  }
      "TerminalSistema": "ANU01"
	  "Importe": 12.00,
	  "Detalle": [],	  
  }
						

Ejemplo Estructura Request Modo de Ingreso BANDA

	
application/json, text/json
{
  "IdentificadorCliente": "TEST-PINPAD-32756",
  "Tarjeta": {
	  "ModoIngreso": "BANDA",
	  "NumeroTarjeta": "50103903****5088",
	  "SecuenciaTarjeta": null,
	  "FechaExpiracion": "1603",
	  "TrackI": "",
	  "TrackII": "",
	  "CodigoSeguridad": null,
	  "NombreTitular": "ANGIONO,PABLO/",
	  "PaqueteEncriptado": "0967FF695F7A2231102411A1864EECA62104EF1FC6137C3EA377DE104FD258BFF4950C468E363BB9121E3AF39A61515DB0882B4207B6908885E88A1A501A3CB4C438772D9116B42D2E1CC18C94DE0A4E9242C6C7D5B268C0"
	  "CriptogramaEMV": null,
	  "PINBlock": "E66754A55C728987",
	  "TarjetaTipo": "DEBITO",
	  "TipoCuenta": "1", 
  }
    "TerminalCaptura": {
	  "NroSerieFisico": "900-438-211",
	  "NroSerieLogico": "0000555555942862",
	  "Encripta": true,
	  "TipoEncripcion": "1",
	  "VersionSoft": "0319B15",
  }
      "TerminalSistema": "ANU01"
	  "Importe": 12.00,
	  "Detalle": [],	  
  }
						

Información Response

Success: HttpResponse 200 RespuestaTXAutorizacionDto
Bad Request: HttpResponse 400.
Internal Server Error: HttpResponse 500.
Model: RespuestaTXPresenteDto

Propiedad Descripción Tipo Información Adicional

TipoOperacion

Indica el tipo de operación.

string

“COMPRA”, “ANULACION”, “DEVOLUCION”, “ANULADEV”

Fecha

Fecha de la operación.

date

Identificador

Identificador de la operación en Lne API. Único por operación.

string

IdentificadorCliente

Identificador de la operación provista por el cliente. Único por cada operación.

string

Estado

Estado de la operación.

string

"AUTORIZADA", "ANULADA", "NOAUTORIZADA", "ERROR", "ERRORCONFIGURACION", "PENDIENTEANULACION"

CodigoError

Devuelve el código de error de la operación.

integer

Para el Estado “ERROR" siempre es -1. Para el Estado “AUTORIZADA" siempre es 0. Para el Estado “NOAUTORIZADA" devuelve el código ISO de error según el Host Autorizador (ver Anexo II: Códigos de Error Host Autorizador)

Mensaje

"OK" o cualquier otro mensaje generado por la entidad que procesa las autorizaciones.

string

MensajeFormato

"Transacción autorizada" o cualquier otro mensaje generado por la entidad que procesa las autorizaciones.

string

NumeroTarjeta

Número de la tarjeta a procesar. Sin espacios en blancos ni separadores.

string

NumeroCuenta

Número de cuenta asociada a la tarjeta

string

ModoIngreso

Modo de Ingreso

string

"MANUAL", "BANDA", "CHIP", "CONTACTLESS".

Terminal

Identificador de la terminal

string

Lote

Número de lote generado por la entidad que procesa las autorizaciones.

integer

Cupon

Número de cupón generado por la entidad que procesa las autorizaciones.

integer

CodigoAutorizacion

Código de autorización generado por la entidad que procesa las autorizaciones. Sólo se genera para las operaciones autorizadas.

string

CriptogramaEMVRespuesta

Es el criptograma de seguridad de PIN PAD que confirma la operación.

string

CodigoRespuesta

Devuelve el código de respuesta.

string

Detalle

Detalle de las autorizaciones de la operación.

Collection of RespuestaDetallePresenteDto

POST api/v2/presente/reverso

Realiza el reverso de una operación.
Los métodos para trabajar con Line necesitan recibir el token de seguridad en el Header Authorization: ApiKey {token}
Para el ambiente de Test el header de Autorizacion es Authorization: ApiKey eb0872bebd934e1c94979f7476c68242

Información Request

Parámetros URI

No lleva parámetros.

Post Body

ReversoTXPresenteDto

Propiedad Descripción Tipo Información Adicional

IdentificadorCliente

Identificador de la operación provista por el cliente. Único por cada operación. Ejemplo:“36152DRF232”

string

TipoOperacion

Indica el tipo de operación.

“COMPRA”, “ANULACION”, “DEVOLUCION”, “ANULADEV”

CodigoErrorAdvice

Identifica tipo de reverso: “Z3”, “”. Los reversos de comunicaciones simples, llevan el valor “”. En caso de no poder grabar el CHIP de la tarjeta, el valor debe ser “Z3”.

string

Tarjeta

Agrupador datos de la tarjeta.

TarjetaPresenteDto

TerminalCaptura

Información del Pin Pad de captura.

TerminalCapturaDto

Si no utiliza Pin Pad no aplica

Ejemplo Estructura Request

application/json, text/json

Información Response

Success: HttpResponse 200 RespuestaTXAutorizacionDto
Bad Request: HttpResponse 400.
Internal Server Error: HttpResponse 500.
Model: RespuestaTXPresenteDto

Propiedad Descripción Tipo Información Adicional

TipoOperacion

Indica el tipo de operación.

string

“COMPRA”, “ANULACION”, “DEVOLUCION”, “ANULADEV”

Fecha

Fecha de la operación.

date

Identificador

Identificador de la operación en Line API. Único por operación.

string

IdentificadorCliente

Identificador de la operación provista por el cliente. Único por cada operación.

string

Estado

Estado de la operación.

string

"AUTORIZADA", "ANULADA", "NOAUTORIZADA", "ERROR", "ERRORCONFIGURACION", "PENDIENTEANULACION"

CodigoError

Devuelve el código de error de la operación.

integer

Para el Estado “ERROR" siempre es -1. Para el Estado “AUTORIZADA" siempre es 0. Para el Estado “NOAUTORIZADA" devuelve el código ISO de error según el Host Autorizador (ver Anexo II: Códigos de Error Host Autorizador)

Mensaje

"OK" o cualquier otro mensaje generado por la entidad que procesa las autorizaciones.

string

MensajeFormato

"Transacción autorizada" o cualquier otro mensaje generado por la entidad que procesa las autorizaciones.

string

NumeroTarjeta

Número de la tarjeta a procesar. Sin espacios en blancos ni separadores.

string

NumeroCuenta

Número de cuenta asociada a la tarjeta.

string

modoIngreso

Modo de Ingreso.

string

"MANUAL", "BANDA", "CHIP", "CONTACTLESS"

Terminal

Identificador de la terminal

string

Lote

Número de lote generado por la entidad que procesa las autorizaciones.

integer

Cupon

Número de cupón generado por la entidad que procesa las autorizaciones.

integer

CodigoAutorizacion

Código de autorización generado por la entidad que procesa las autorizaciones. Sólo se genera para las operaciones autorizadas.

string

CriptogramaEMVRespuesta

Es el criptograma de seguridad de PIN PAD que confirma la operación.

string

CodigoRespuesta

Devuelve el código de respuesta.

string

Detalle

Detalle de las autorizaciones de la operación.

Collection of RespuestaDetallePresenteDto

GET api/v2/presente/emisores/{canalVenta}

Obtiene los emisores disponibles por canal de venta.
Los métodos para trabajar con Line necesitan recibir el token de seguridad en el Header Authorization: ApiKey {token}
Para el ambiente de Test el header de Autorizacion es Authorization: ApiKey eb0872bebd934e1c94979f7476c68242

Información Request

Parámetros URI

Propiedad Descripción Tipo Información Adicional

canalventa

Indica el canal de ventas:"PDV", "WEB". Ejemplo: “PDV”

string

Requerido. Debe respetarse las mayúsculas.

Ejemplo Estructura Request

GET api/v2/presente/emisores/PDV

Información Response

Success: HttpResponse 200 List EmisorDto
Bad Request: HttpResponse 400.
Internal Server Error: HttpResponse 500.
Model: Collection of EmisorDto

Propiedad Descripción Tipo Información Adicional

Codigo

Código del emisor.

string

CvcSize

Longitud del CVC de la tarjeta.

integer

Retorna 0 si no tiene CVC.

DevolucionOnline

Permite devolución online.

boolean

FormatoTarjeta

Formato de la tarjeta según el emisor.

string

HasCVC

Indica si el tipo de tarjeta del emisor tienen CVC.

boolean

HasExpirationDate

Indica si el tipo de tarjeta del emisor tienen fecha de expiración.

boolean

Nombre

Nombre del emisor.

string

Prioridad

Prioridad del tipo de tarjeta según el emisor. Orden descendente, de más específica a más genérica.

integer

Ejemplo: "VisaRio prioridad 2", "Visa prioridad 1"

Rango

Expresión Regular del formato del número de la tarjeta.

string

ValidateLuhnCheck

Indica si se debe realizar la validación del Luhn (Algoritmo de módulo 10).

boolean

ImagenUrl

URL de la imagen del emisor

string

CodigoEntidad

Código de la Entidad de la tarjeta.

string

TarjetaTipo

Tipo de Tarjeta.

string

GET api/v2/presente/emisores/{canalVenta}/{codigoEmisor}

Obtiene la información de un Emisor.
Los métodos para trabajar con Line necesitan recibir el token de seguridad en el Header Authorization: ApiKey {token}
Para el ambiente de Test el header de Autorizacion es Authorization: ApiKey eb0872bebd934e1c94979f7476c68242

Información Request

Parámetros URI

Propiedad Descripción Tipo Información Adicional

canalventa

Indica el canal de ventas:"PDV", "WEB". Ejemplo: “PDV”

string

Requerido. Debe respetarse las mayúsculas.

codigoEmisor

Código del emisor con el que se realizó la operación "VISA", “ELECTRON”, "MASTER", "AMEX", "NARANJA", etc. Ejemplo: “VISA”

string

Requerido. Debe respetarse las mayúsculas. Consulte el Anexo I: Códigos de Emisores.

Ejemplo Estructura Request

GET api/v2/presente/emisores/WEB/VISA

Información Response

Success: HttpResponse 200 EmisorDto
Bad Request: HttpResponse 400.
Internal Server Error: HttpResponse 500.
Model: EmisorDto

Propiedad Descripción Tipo Información Adicional

Codigo

Código del emisor.

string

CvcSize

Longitud del CVC de la tarjeta.

integer

Retorna 0 si no tiene CVC.

DevolucionOnline

Indicador si permite devolución online.

boolean

FormatoTarjeta

Formato de la tarjeta según el emisor.

string

HasCVC

Indica si el tipo de tarjeta del emisor tienen CVC.

boolean

HasExpirationDate

Indica si el tipo de tarjeta del emisor tienen fecha de expiración.

boolean

Nombre

Nombre del emisor.

string

Prioridad

Prioridad del tipo de tarjeta según el emisor. Orden descendente, de más específica a más genérica.

integer

Ejemplo: "VisaRio prioridad 2", "Visa prioridad 1"

Rango

Expresión Regular del formato del número de la tarjeta.

string

ValidateLuhnCheck

Indica si se debe realizar la validación del Luhn (Algoritmo de módulo 10).

boolean

ImagenUrl

URL de la imagen del emisor

string

CodigoEntidad

Código de la Entidad de la tarjeta.

string

TarjetaTipo

Tipo de Tarjeta.

string

GET api/v2/presente/comercios

Obtiene los comercios de un cliente.
Los métodos para trabajar con Line necesitan recibir el token de seguridad en el Header Authorization: ApiKey {token}
Para el ambiente de Test el header de Autorizacion es Authorization: ApiKey eb0872bebd934e1c94979f7476c68242

Información Request

Parámetros URI

No lleva parámetros

Ejemplo Estructura Request

GET api/v2/presente/comercios

Información Response

Success: HttpResponse 200 ComercioDto
Bad Request: HttpResponse 400.
Internal Server Error: HttpResponse 500.
Model: Collection of ComercioDto

Propiedad Descripción Tipo Información Adicional

CanalVenta

Canal de venta.

string

NumeroComercio

Número de comercio

string

Descripcion

Descripción del comercio

string

HostAutorizador

Host autorizador

string

CodigoEntidad

Código de entidad

string

RazonSocial

Razón social del comercio.

string

CUIT

CUIT del comercio.

string

NombreFantasia

Nombre de fantasía del comercio.

string

GET api/v2/presente/comercios/{canalVenta}/{numeroComercio}

Obtiene un comercio por canal de venta y número de comercio.
Los métodos para trabajar con Line necesitan recibir el token de seguridad en el Header Authorization: ApiKey {token}
Para el ambiente de Test el header de Autorizacion es Authorization: ApiKey eb0872bebd934e1c94979f7476c68242

Información Request

Parámetros URI

Propiedad Descripción Tipo Información Adicional

CanalVenta

Indica el canal de ventas: "PDV", "WEB". Debe respetarse las mayúsculas. Ejemplo: “WEB”

string

Requerido

numeroComercio

Número de comercio. Ejemplo:"10789292"/p>

string

Requerido

Ejemplo Estructura Request

GET api/v2/presente/comercios/WEB/10789292

Información Response

Success: HttpResponse 200 ComercioDto
Bad Request: HttpResponse 400.
Internal Server Error: HttpResponse 500.
Model: ComercioDto

Propiedad Descripción Tipo Información Adicional

CanalVenta

Canal de venta.

string

NumeroComercio

Número de comercio

string

Descripcion

Descripción del comercio

string

HostAutorizador

Host autorizador

string

CodigoEntidad

Código de entidad

string

RazonSocial

Razón social del comercio.

string

CUIT

CUIT del comercio.

string

NombreFantasia

Nombre de fantasía del comercio.

string

GET api/v2/presente/conexiones/estado

Obtiene el estado de las conexiones.

Información Request

Parámetros URI

No lleva parámetros

Ejemplo Estructura Request

GET api/v2/presente/conexiones/estado

Información Response

Success: HttpResponse 200 List ConexionHostDto
Bad Request: HttpResponse 400.
Internal Server Error: HttpResponse 500.
Model: Collection of ConexionHostDto

Propiedad Descripción Tipo Información Adicional

Host

Host.

string

Estado

Estado del Host

string

FechaUltimaVerificacion

Fecha y hora en que se realizó la última verificación del estado del Host

date

GET api/v2/presente/conexiones/estado/{host}

Obtiene el estado de una conexión en particular.

Información Request

Parámetros URI

Propiedad Descripción Tipo Información Adicional

host

Identificación del Host cuyo estado se desea consultar. Ejemplo:”PRISMAVISA”

string

Requerido. Debe respetarse las mayúsculas. AMEX, PRISMAVISA, PRISMAMASTER,FIRSTDATA1, FIRSTDATACAL

Ejemplo Estructura Request

GET api/v2/presente/conexiones/estado/PRISMAVISA

Información Response

Success: HttpResponse 200 ConexionHostDto
Bad Request: HttpResponse 400.
Internal Server Error: HttpResponse 500.
Model: ConexionHostDto

Propiedad Descripción Tipo Información Adicional

Host

Host.

string

Estado

Estado del Host

string

FechaUltimaVerificacion

Fecha y hora en que se realizó la última verificación del estado del Host

date

Transacciones recurrentes


Para operaciones recurrentes, como por ejemplo cuotas de clubes, servicios de medicina prepaga, pago de cuotas mensuales de afiliados, etc.

La operatoria se realiza de la siguiente forma: se realiza el pago inicial, el cual incluye todos los datos de la tarjeta, incluido el código de seguridad, y los pagos subsiguientes, que no lo requieren. Como respuesta al pago inicial se genera un token que se asocia a dicha tarjeta, el cual es utilizado para el resto de los pagos de ese cliente con esa tarjeta.

Los métodos para trabajar con Line necesitan recibir el token de seguridad en el Header Authorization: ApiKey {token}

Para el ambiente de Test el header de Autorizacion es Authorization: ApiKey eb0872bebd934e1c94979f7476c68242

API Description

POST api/v1/recurrente/pagoinicial

Para realizar pagos recurrentes se debe realizar el primer pago, por única vez por tarjeta, a través de este método. Se obtiene como respuesta un token de la tarjeta.

POST api/v1/recurrente/pago

Método utilizado para realizar los pagos subsiguientes de forma recurrente. Este método debe ser llamado por tarjeta una vez que tenga el token generado en el método api/v1/recurrente/pagoinicial

POST api/v1/recurrente/anulacion/{identificador}

Realiza la anulación/devolución de una operación realizada por pago recurrente

POST api/v1/recurrente/pagoinicial

Para realizar pagos recurrentes se debe realizar el primer pago, por única vez por tarjeta, a través de este método.
Los métodos para trabajar con Line necesitan recibir el token de seguridad en el Header Authorization: ApiKey {token}
Para el ambiente de Test el header de Autorizacion es Authorization: ApiKey eb0872bebd934e1c94979f7476c68242

Información Request

Parámetros URI

No lleva parámetros.

Post Body

Datos de la operación a autorizar (por primera y única vez por tarjeta)

SolicitudRecurrenteInicialDto

Propiedad Descripción Tipo Información Adicional

IdentificadorCliente

Identificador de la operación provista por el cliente. Único por cada operación. Ejemplo: “JPR3x119RVP”

string

Moneda

Identifica la moneda de la operación: ARS, U$S. Ejemplo: “ARS”

string

Deben respetarse las mayúsculas.

Referencia

Información del cliente. Texto libre. Se visualiza en los reportes y en las descargas de información. Ejemplo: “Pago inicial - Noviembre 2018”

string

NumeroComercio

Número de comercio. Debe ser un número de comercio generado especialmente para pagos recurrentes. Ejemplo: “40876”

string

Importe

Importe a debitar. Ejemplo: 4540.45

decimal number

Sin separador de miles. El punto (“.”) es el separador decimal.

TarjetaTipo

Tipo de Tarjeta ("CREDITO" o "DEBITO"). Ejemplo; “CREDITO”

string

Deben respetarse las mayúsculas.

CodigoEmisor

Código del emisor con el que se realizó la operación ("VISA", “ELECTRON”, "MASTER", "AMEX", "NARANJA", etc.). Ejemplo: “MASTER”

string

Deben respetarse las mayúsculas. Consulte el Anexo I: Códigos de Emisores.

NumeroTarjeta

Número de la tarjeta a procesar. Ejemplo:”51402578944578”

string

Sin espacios en blancos ni separadores.

FechaExpiración

Fecha de expiración de la tarjeta. Ejemplo:2402

string

Formato YYMM.

CodigoSeguridad

Código de seguridad de la tarjeta. Ejemplo: “756”

string

TipoDocumentoTitular

Tipo de documento del titular de la tarjeta ("DNI", "Pasaporte", "LibretaEnrolamiento", "LibretaCivica"). Ejemplo:”DNI”

string

DocumentoTitular

Número de documento del titular de la tarjeta. Ejemplo:”40480861”

string

NombreTitular

Nombre del titular como figura en la tarjeta. Ejemplo: “María Pérez”

string

EmailTitular

Correo electrónico del titular de la tarjeta. Ejemplo: “mperez@sucorreo.com”

string

Ejemplo Estructura Request

	
application/json, text/json
{
  "IdentificadorCliente": "JPR3x119RVP",
  "Moneda": "ARS",
  "Referencia": "Pago inicial - Noviembre 2018",
  "NumeroComercio": "40876",
  "Importe": 4540.45,
  "TarjetaTipo": "CREDITO",
  "CodigoEmisor": "MASTER",
  "NumeroTarjeta": "51402578944578",
  "FechaExpiracion": "2402",
  "CodigoSeguridad": "756",
  "TipoDocumentoTitular": "DNI",
  "DocumentoTitular": "40480861",
  "NombreTitular": "María Pérez",
  "EmailTitular": "mperez@sucorreo.com", 
}
						

Información Response

Success: HttpResponse 200 RespuestaRecurrenteDto
Bad Request: HttpResponse 400.
Internal Server Error: HttpResponse 500.
Model: RespuestaRecurrenteDto

Propiedad Descripción Tipo Información Adicional

Identificador

Identificador de la operación en Line API. Único por operación.

string

IdentificadorCliente

Identificador de la operación provista por el cliente. Único por cada operación.

string

Estado

Estado de la operación.

string

"AUTORIZADA", "ANULADA", "NOAUTORIZADA", "ERROR", "ERRORCONFIGURACION", "PENDIENTEANULACION"

CodigoError

Devuelve el código de error de la operación.

integer

Para el Estado “ERROR" siempre es -1. Para el Estado “AUTORIZADA" siempre es 0. Para el Estado “NOAUTORIZADA" devuelve el código ISO de error según el Host Autorizador (ver Anexo II: Códigos de Error Host Autorizador)

Mensaje

"OK" o cualquier otro mensaje generado por la entidad que procesa las autorizaciones.

string

MensajeFormato

"Transacción autorizada" o cualquier otro mensaje generado por la entidad que procesa las autorizaciones.

string

Token

Token asociado a la tarjeta utilizada.

string

Fecha

Fecha de la respuesta

date

Terminal

Identificación de la terminal

string

Lote

Número de lote generado por la entidad que procesa las autorizaciones.

integer

Cupon

Número de cupón generado por la entidad que procesa las autorizaciones.

integer

CodigoAutorizacion

Código de autorización generado por la entidad que procesa las autorizaciones. Sólo se genera para las operaciones autorizadas.

string

POST api/v1/recurrente/pago

Método utilizado para realizar los pagos subsiguientes de forma recurrente. Este método debe ser llamado por tarjeta una vez que tenga el Token generado en el método api/v1/recurrente/pagoinicial
Los métodos para trabajar con Line necesitan recibir el token de seguridad en el Header Authorization: ApiKey {token}
Para el ambiente de Test el header de Autorizacion es Authorization: Authorization: ApiKey eb0872bebd934e1c94979f7476c68242

Información Request

Parámetros URI

No lleva parámetros.

Post Body

Datos de la operación a autorizar (el token debe ser generado en el método de pagoinicial).

SolicitudRecurrenteDto

Propiedad Descripción Tipo Información Adicional

IdentificadorCliente

Identificador de la operación provista por el cliente. Único por cada operación. Ejemplo: “JUSK373636E43”

string

Moneda

Identifica la moneda de la operación: ARS, U$S. Deben respetarse las mayúsculas. Ejemplo: “ARS”

string

Token

Token de la tarjeta a procesar. Ejemplo: “347bc7d7-6854-44b9-aec3-4a947fac71bf”

string

Referencia

Información del cliente. Texto libre. Se visualiza en los reportes y en las descargas de información. Ejemplo: “Cuota Enero 2018”

string

NumeroComercio

Número de comercio. Debe ser un número de comercio generado especialmente para pagos recurrentes. Ejemplo: “40876”

string

Importe

Importe a debitar. Ejemplo: 6708.27

decimal number

Sin separador de miles. El punto (“.”) es el separador decimal.

Ejemplo Estructura Request

	
application/json, text/json
{
  "IdentificadorCliente": "JUSK373636E43",
  "Moneda": "ARS",
  "Token": "347bc7d7-6854-44b9-aec3-4a947fac71bf",  
  "Referencia": "Cuota Enero 2018",
  "NumeroComercio": "40873",
  "Importe": 6708.27
}
						

Información Response

Success: HttpResponse 200 RespuestaRecurrenteDto
Bad Request: HttpResponse 400.
Internal Server Error: HttpResponse 500.
Model: RespuestaRecurrenteDto

Propiedad Descripción Tipo Información Adicional

Identificador

Identificador de la operación en Line API. Único por operación.

string

IdentificadorCliente

Identificador de la operación provista por el cliente. Único por cada operación.

string

Estado

Estado de la operación.

string

"AUTORIZADA", "ANULADA", "NOAUTORIZADA", "ERROR", "ERRORCONFIGURACION", "PENDIENTEANULACION"

CodigoError

Devuelve el código de error de la operación.

integer

Para el Estado “ERROR" siempre es -1. Para el Estado “AUTORIZADA" siempre es 0. Para el Estado “NOAUTORIZADA" devuelve el código ISO de error según el Host Autorizador (ver Anexo II: Códigos de Error Host Autorizador)

Mensaje

"OK" o cualquier otro mensaje generado por la entidad que procesa las autorizaciones.

string

MensajeFormato

"Transacción autorizada" o cualquier otro mensaje generado por la entidad que procesa las autorizaciones.

string

Token

Token de la tarjeta utilizada.

string

Fecha

Fecha de la respuesta

date

Terminal

Identificación de la terminal

string

Lote

Número de lote generado por la entidad que procesa las autorizaciones.

integer

Cupon

Número de cupón generado por la entidad que procesa las autorizaciones.

integer

CodigoAutorizacion

Código de autorización generado por la entidad que procesa las autorizaciones. Sólo se genera para las operaciones autorizadas.

string

POST api/v1/recurrente/anulacion/{identificador}

Realiza la anulación/devolución de una operación realizada por pago recurrente, sea el primer pago o lo subsecuentes.
Los métodos para trabajar con Line necesitan recibir el token de seguridad en el Header Authorization: ApiKey {token}
Para el ambiente de Test el header de Autorizacion es Authorization: Authorization: ApiKey eb0872bebd934e1c94979f7476c68242

Información Request

Parámetros URI

Propiedad Descripción Tipo Información Adicional

identificador

Identificador de la operación provista por el cliente. Único por cada operación. Ejemplo: “MSG66524YHD”

string

Requerido

Post Body

No lleva parámetros.

Ejemplo Estructura Request

POST api/v1/recurrente/anulacion/MSG66524YHD

Información Response

Success: HttpResponse 200 RespuestaRecurrenteDto
Bad Request: HttpResponse 400.
Internal Server Error: HttpResponse 500.
Model: RespuestaRecurrenteDto

Propiedad Descripción Tipo Información Adicional

Identificador

Identificador de la operación en Line API. Único por operación.

string

IdentificadorCliente

Identificador de la operación provista por el cliente. Único por cada operación.

string

Estado

Estado de la operación.

string

"AUTORIZADA", "ANULADA", "NOAUTORIZADA", "ERROR", "ERRORCONFIGURACION", "PENDIENTEANULACION"

CodigoError

Devuelve el código de error de la operación.

integer

Para el Estado “ERROR" siempre es -1. Para el Estado “AUTORIZADA" siempre es 0. Para el Estado “NOAUTORIZADA" devuelve el código ISO de error según el Host Autorizador (ver Anexo II: Códigos de Error Host Autorizador)

Mensaje

"OK" o cualquier otro mensaje generado por la entidad que procesa las autorizaciones.

string

MensajeFormato

"Transacción autorizada" o cualquier otro mensaje generado por la entidad que procesa las autorizaciones.

string

Token

Token de la tarjeta utilizada.

string

Fecha

Fecha de la respuesta

date

Terminal

Identificación de la terminal

string

Lote

Número de lote generado por la entidad que procesa las autorizaciones.

integer

Cupon

Número de cupón generado por la entidad que procesa las autorizaciones.

integer

CodigoAutorizacion

Código de autorización generado por la entidad que procesa las autorizaciones. Sólo se genera para las operaciones autorizadas.

string

Transacciones en Dos Pasos (Pre Autorización)


Las Transacciones en Dos Pasos son también conocidas como Pre Autorización y Captura son operaciones que se realizan en en dos fases.

Utilizado habitualmente por los supermercados para las compras on line. El cliente realiza el pedido e ingresa los datos de la tarjeta. Esto genera una pre autorización y reserva de monto en la tarjeta del cliente pero no genera aún el consumo. Luego de que el pedido se prepara, se realiza un segundo paso en el que se indica el monto efectivamente a facturar.

Primero se usa el método solicitud y luego captura. El método anulación, según como sea invocado, permite la anulación parcial o total de una operación.

Los métodos para trabajar con Line necesitan recibir el token de seguridad en el Header Authorization: ApiKey {token}

Para el ambiente de Test el header de Autorizacion es Authorization: ApiKey eb0872bebd934e1c94979f7476c68242

API Description

POST api/v2/preautorizacion/solicitud

Solicitud de preautorización de la operación; no produce aún el impacto del consumo.

POST api/v2/preautorizacion/captura/{identificador}/{identificadorPreAutorizacion}/{importe}

Segundo paso de la transacción; genera el impacto del consumo por el importe final indicado.

POST api/v2/preautorizacion/anulacion/{identificador}

Realiza la anulación/devolución de una operación

POST api/v2/preautorizacion/anulacion/{identificador}/{importe}

Realiza la anulación/devolución parcial de una operación

POST api/v2/preautorizacion/solicitud

Para realizar pagos con el modelo Pre-Autorización y Captura, primero debe invocarse este método, que es la solicitud de pre-autorización.
Los métodos para trabajar con Line necesitan recibir el token de seguridad en el Header Authorization: ApiKey {token}
Para el ambiente de Test el header de Autorizacion es Authorization: ApiKey eb0872bebd934e1c94979f7476c68242

Información Request

Parámetros URI

No lleva parámetros.

Post Body

Datos de la operación a autorizar (por primera y única vez por tarjeta)

SolicitudPreAutorizacionDto

Propiedad Descripción Tipo Información Adicional

IdentificadorCliente

Identificador de la operación provista por el cliente. Único por cada operación. Ejemplo: “JPS74S67A20S”

string

Longitud máxima 40 caracteres alfanuméricos.

Moneda

Identifica la moneda de la operación: ARS, U$S. Deben respetarse las mayúsculas. Ejemplo: “ARS”

string

Referencia

Información del cliente. Texto libre. Se visualiza en los reportes y en las descargas de información. Ejemplo: “SKU 9877-M-Negro”

string

Longitud máxima 20 caracteres alfanuméricos.

NumeroComercio

Número de comercio. Ejemplo: “25147369”

string

Importe

Importe a debitar. Ejemplo: 4540.45

decimal number

Sin separador de miles. El punto (“.”) es el separador decimal.

Cuotas

Cantidad de cuotas. Si es en un pago, el valor es 1. Ejemplo: 1

integer

TarjetaTipo

Tipo de Tarjeta ("CREDITO" o "DEBITO"). Ejemplo; “CREDITO”

string

Deben respetarse las mayúsculas.

CodigoEmisor

Código del emisor con el que se realizó la operación ("VISA", “ELECTRON”, "MASTER", "AMEX", "NARANJA", etc.). Ejemplo: “MASTER”

string

Deben respetarse las mayúsculas. Consulte el Anexo I: Códigos de Emisores.

NumeroTarjeta

Número de la tarjeta a procesar. Ejemplo:"4540110066449977"

string

Sin espacios en blancos ni separadores.

FechaExpiración

Fecha de expiración de la tarjeta. Ejemplo: "2408"

string

Formato YYMM.

CodigoSeguridad

Código de seguridad de la tarjeta. Ejemplo: “014”

string

DocumentoTitular

Número de documento del titular de la tarjeta. Ejemplo:”18123456”

string

NombreTitular

Nombre del titular como figura en la tarjeta. Ejemplo: “Juan Equis”

string

EmailTitular

Correo electrónico del titular de la tarjeta. Ejemplo: “ejemplo@sumail.com”

string

Ejemplo Estructura Request

	
application/json, text/json
{
  "IdentificadorCliente": "JPS74S67A20S",
  "Moneda": "ARS",
  "Referencia": "SKU 9877-M-Negro",
  "NumeroComercio": "25147369",
  "Importe": 4540.45,
  "Cuotas": 6,  
  "TarjetaTipo": "CREDITO",
  "CodigoEmisor": "VISA",
  "NumeroTarjeta": "4540110066449977",
  "FechaExpiracion": "2408",
  "CodigoSeguridad": "014",
  "DocumentoTitular": "18123456",
  "NombreTitular": "Juan Equis",
  "EmailTitular": "ejemplo@sumail.com", 
}
						

Información Response

Success: HttpResponse 200 RespuestaRecurrenteDto
Bad Request: HttpResponse 400.
Internal Server Error: HttpResponse 500.
Model: RespuestaPreAutorizacionDto

Propiedad Descripción Tipo Información Adicional

Identificador

Identificador de la operación en Line API. Único por operación.

string

IdentificadorCliente

Identificador de la operación provista por el cliente. Único por cada operación.

string

Estado

Estado de la operación.

string

"AUTORIZADA", "ANULADA", "NOAUTORIZADA", "ERROR", "ERRORCONFIGURACION", "PENDIENTEANULACION"

CodigoError

Devuelve el código de error de la operación.

integer

Para el Estado “ERROR" siempre es -1. Para el Estado “AUTORIZADA" siempre es 0. Para el Estado “NOAUTORIZADA" devuelve el código ISO de error según el Host Autorizador (ver Anexo II: Códigos de Error Host Autorizador)

Mensaje

"OK" o cualquier otro mensaje generado por la entidad que procesa las autorizaciones.

string

MensajeFormato

"Transacción autorizada" o cualquier otro mensaje generado por la entidad que procesa las autorizaciones.

string

Pri6Digitos

Primeros 6 dígitos de la tarjeta

string

Ult4Digitos

Últimos 4 dígitos de la tarjeta

string

NumeroTarjeta

Número de tarjeta

string

Fecha

Fecha de la respuesta

date

Terminal

Identificación de la terminal

string

Lote

Número de lote generado por la entidad que procesa las autorizaciones.

integer

Cupon

Número de cupón generado por la entidad que procesa las autorizaciones.

integer

CodigoAutorizacion

Código de autorización generado por la entidad que procesa las autorizaciones. Sólo se genera para las operaciones autorizadas.

string

POST api/v2/preautorizacion/captura/{identificador}/{identificadorPreAutorizacion}/{importe}

Método utilizado para realizar el segundo paso del pago, denominado Captura, el cual hace efectivo al mismo. Este método debe ser llamado por tarjeta una vez que tenga el token generado en el método api/v2/preautorizacion/solicitud.
Los métodos para trabajar con Line necesitan recibir el token de seguridad en el Header Authorization: ApiKey {token}
Para el ambiente de Test el header de Autorizacion es Authorization: ApiKey eb0872bebd934e1c94979f7476c68242

Información Request

Parámetros URI

Propiedad Descripción Tipo Información Adicional

identificador

Identificador de la operación provista por el cliente. Único por cada operación. Ejemplo: ”A78DB8B2-34BE-5CFB-477E-627D8A97EC2E”

string

Requerido

identificadorPreAutorizacion

Es el identificador único de la operación provista por el cliente en el método solicitud (api/v2/preautorizacion/solicitud). Ejemplo: “JPS74S67A20S”

string

Requerido

importe

Importe a debitar. Ejemplo: 2300.50

decimal number

Requerido. Sin separador de miles. El punto (“.”) es el separador decimal.

Post Body

No lleva parámetros.

Ejemplo Estructura Request

POST api/v2/preautorizacion/captura/A78DB8B2-34BE-5CFB-477E-627D8A97EC2E/JPS74S67A20S/2300.50

Información Response

Success: HttpResponse 200 RespuestaRecurrenteDto
Bad Request: HttpResponse 400.
Internal Server Error: HttpResponse 500.
Model: RespuestaRecurrenteDto

Propiedad Descripción Tipo Información Adicional

Identificador

Identificador de la operación en Line API. Único por operación.

string

IdentificadorCliente

Identificador de la operación provista por el cliente. Único por cada operación.

string

Estado

Estado de la operación.

string

"AUTORIZADA", "ANULADA", "NOAUTORIZADA", "ERROR", "ERRORCONFIGURACION", "PENDIENTEANULACION"

CodigoError

Devuelve el código de error de la operación.

integer

Para el Estado “ERROR" siempre es -1. Para el Estado “AUTORIZADA" siempre es 0. Para el Estado “NOAUTORIZADA" devuelve el código ISO de error según el Host Autorizador (ver Anexo II: Códigos de Error Host Autorizador)

Mensaje

"OK" o cualquier otro mensaje generado por la entidad que procesa las autorizaciones.

string

MensajeFormato

"Transacción autorizada" o cualquier otro mensaje generado por la entidad que procesa las autorizaciones.

string

Token

Token de la tarjeta utilizada.

string

Fecha

Fecha de la respuesta

date

Terminal

Terminal

string

Lote

Número de lote generado por la entidad que procesa las autorizaciones.

integer

Cupon

Número de cupón generado por la entidad que procesa las autorizaciones.

integer

CodigoAutorizacion

Código de autorización generado por la entidad que procesa las autorizaciones. Sólo se genera para las operaciones autorizadas.

string

POST api/v2/preautorizacion/anulacion/{identificador}

Realiza la anulación/devolución de una operación.
Los métodos para trabajar con Line necesitan recibir el token de seguridad en el Header Authorization: ApiKey {token}
Para el ambiente de Test el header de Autorizacion es Authorization: ApiKey eb0872bebd934e1c94979f7476c68242

Información Request

Parámetros URI

Propiedad Descripción Tipo Información Adicional

identificador

Identificador de la operación provista por el cliente. Único por cada operación. Ejemplo: “JL666S00AS99”

string

Requerido

Post Body

No lleva parámetros.

Ejemplo Estructura Request

POST api/v2/preautorizacion/anulacion/JL666S00AS99

Información Response

Success: HttpResponse 200 RespuestaTXAutorizacionDto
Bad Request: HttpResponse 400.
Internal Server Error: HttpResponse 500.
Model: RespuestaPreAutorizacionDto

Propiedad Descripción Tipo Información Adicional

Identificador

Identificador de la operación en Line API. Único por operación.

string

IdentificadorCliente

Identificador de la operación provista por el cliente. Único por cada operación.

string

Estado

Estado de la operación.

string

"AUTORIZADA", "ANULADA", "NOAUTORIZADA", "ERROR", "ERRORCONFIGURACION", "PENDIENTEANULACION"

CodigoError

Devuelve el código de error de la operación.

integer

Para el Estado “ERROR" siempre es -1. Para el Estado “AUTORIZADA" siempre es 0. Para el Estado “NOAUTORIZADA" devuelve el código ISO de error según el Host Autorizador (ver Anexo II: Códigos de Error Host Autorizador)

Mensaje

"OK" o cualquier otro mensaje generado por la entidad que procesa las autorizaciones.

string

MensajeFormato

"Transacción autorizada" o cualquier otro mensaje generado por la entidad que procesa las autorizaciones.

string

Pri6Digitos

Primeros 6 dígitos de la tarjeta

string

Ult4Digitos

Últimos 4 dígitos de la tarjeta

string

NumeroTarjeta

Número de Tarjeta

string

Fecha

Fecha de la respuesta

date

Terminal

Identificación de la terminal

string

Lote

Número de lote generado por la entidad que procesa las autorizaciones.

integer

Cupon

Número de cupón generado por la entidad que procesa las autorizaciones.

integer

CodigoAutorizacion

Código de autorización generado por la entidad que procesa las autorizaciones. Sólo se genera para las operaciones autorizadas.

string

POST api/v2/preautorizacion/anulacion/{identificador}/{importe}

Realiza la anulación/devolución parcial de una operación.
Los métodos para trabajar con Line necesitan recibir el token de seguridad en el Header Authorization: ApiKey {token}
Para el ambiente de Test el header de Autorizacion es Authorization: ApiKey eb0872bebd934e1c94979f7476c68242

Información Request

Parámetros URI

Propiedad Descripción Tipo Información Adicional

identificador

Identificador de la operación provista por el cliente. Único por cada operación. Ejemplo: “SAS196708CG”

string

Requerido

importe

Importe a debitar. Ejemplo: 1200.00

decimal number

Requerido. Sin separador de miles. El punto (“.”) es el separador decimal.

Post Body

No lleva parámetros.

Ejemplo Estructura Request

POST api/v2/preautorizacion/anulacion/SAS196708CG/1200.00

Información Response

Success: HttpResponse 200 RespuestaTXAutorizacionDto
Bad Request: HttpResponse 400.
Internal Server Error: HttpResponse 500.
Model: RespuestaPreAutorizacionDto

Propiedad Descripción Tipo Información Adicional

Identificador

Identificador de la operación en Line API. Único por operación.

string

IdentificadorCliente

Identificador de la operación provista por el cliente. Único por cada operación.

string

Estado

Estado de la operación.

string

"AUTORIZADA", "ANULADA", "NOAUTORIZADA", "ERROR", "ERRORCONFIGURACION", "PENDIENTEANULACION"

CodigoError

Devuelve el código de error de la operación.

integer

Para el Estado “ERROR" siempre es -1. Para el Estado “AUTORIZADA" siempre es 0. Para el Estado “NOAUTORIZADA" devuelve el código ISO de error según el Host Autorizador (ver Anexo II: Códigos de Error Host Autorizador)

Mensaje

"OK" o cualquier otro mensaje generado por la entidad que procesa las autorizaciones.

string

MensajeFormato

"Transacción autorizada" o cualquier otro mensaje generado por la entidad que procesa las autorizaciones.

string

Pri6Digitos

Primeros 6 dígitos de la tarjeta

string

Ult4Digitos

Últimos 4 dígitos de la tarjeta

string

NumeroTarjeta

Número de Tarjeta

string

Fecha

Fecha de la respuesta

date

Terminal

Identificación de la terminal

string

Lote

Número de lote generado por la entidad que procesa las autorizaciones.

integer

Cupon

Número de cupón generado por la entidad que procesa las autorizaciones.

integer

CodigoAutorizacion

Código de autorización generado por la entidad que procesa las autorizaciones. Sólo se genera para las operaciones autorizadas.

string

Anexo I: Códigos de Emisores


Nombre Código

American Express

AMEX

American Macro

AMEXMACRO

American Patagonia

AMEXPATAGO

American Santander

AMEXRIO

AMEX Santander Selecta

AMEXRIOSEL

CABAL Municipal Rosario

CABAMUNRO

CABAL

CABAL

Club Arnet

CLUBARNET

Club La Nacion

CLUBNACION

Club Personal

CLUBPERSON

Diners

DINERS

Débito CABAL

DEBITOCABAL

Electron Banco Francés

ELECBBVA

Electron Citibank

ELECTCITI

Electron Hipotecario

ELECTBHIP

Electron Macro

ELECMACRO

Electron Patagonia WEB

ELECTPATAGOW

Electron Patagonia

ELECTPATAGO

Electron Santander Selecta

ELECTRIOSE

Electron Santander WEB

ELECTRIOWB

Electron Santander

ELECTRIO

Electrón

ELECTRON

Italcred

ITALCRED

Kadicard

KADICARD

La Capital

LACAPITAL

MAESTRO

MAESTRO

Marcos Juárez

MJUAREZ

MASTER Banco Santa Fe

MASTERSTAFE

MASTER Patagonia

MASTERPATAGO

Mastercad Nativa

MASTERNATI

Mastercard Banco Cordoba

MASTERCBA

Mastercard Banco Córdoba Débito

MASTERCBADEBIT

Mastercard Banco Francés

MASTERBBVA

Mastercard Banco Santander

MASTERRIO

Diners

DINERS

Mastercard Ciudad

MASTERCDAD

Mastercard COMAFI

MASTERCOMAFI

Mastercard Debit Nación

MASTERDEBITNAC

Mastercard Debit

MASTERDEBIT

Mastercard Dinosaurio

MASTERDINO

Mastercard ICBC

MASTERICBC

Mastercard Macro

MASTERMACR

Mastercard Nación

MASTERNAC

Mastercard

MASTER

Nativa

NATIVA

Nevada

NEVADA

Plan Platino

PLAPLATINO

Tarjeta Naranja

NARANJA

Ultra

ULTRA

Visa Banco Cordoba

VISACBA

VISA Banco Francés

VISABBVA

VISA Banco Santa Fe

VISASTAFE

Visa Citibank

VISACITI

VISA Ciudad

VISACIUDAD

VISA COMAFI

VISACOMAFI

Visa Hipotecario

VISABHIP

VISA ICBC

VISAICBC

Visa Macro Selecta

VISAMASELE

Visa Macro

VISAMACRO

VISA Municipal Rosario

VISAMUNRO

VISA Nación

VISANACION

VISA Patagonia

VISAPATAGO

VISA Santander Selecta

VISARIOSEL

VISA Santander

VISARIO

VISA

ELECWEB

VISA

VISA

VYCARD

VYCARD

Anexo II: Códigos de Error Host Autorizador


Códigos de respuesta ISO 8583

Código Descripción Referencia

00

APROBADA (authno)

Operación aprobada, emitir cupón (cargo o ticket).

01

PEDIR AUTORIZACION

Solicitar autorización telefónica, en caso de ser aprobada, cargar el código obtenido y dejar la operación en OFFLINE.

02

PEDIR AUTORIZACION

Idem punto anterior.

03

COMERCIO INVALIDO

Verificar parámetros del sistema, código de comercio mal cargado

04

CAPTURAR TARJETA

Denegada, capturar la tarjeta.

05

DENEGADA

Denegada.

07

RETENGA Y LLAME

Denegada, llamar al Centro de Autorizaciones.

11

APROBADA

Operación aprobada, emitir cupón (cargo o ticket).

12

TRANSAC. INVALIDA

Verificar el sistema, transacción no reconocida en el sistema.

13

MONTO INVALIDO

Verificar el sistema, error en el formato del campo importe.

14

TARJETA INVALIDA

Denegada, tarjeta no corresponde.

25

NO EXISTE ORIGINAL

Denegada, registro no encontrado en el archivo de transacciones.

28

SERVICIO NO DISPONIBLE

Momentáneamente el servicio no está disponible. Se debe reintentar en unos segundos.

30

ERROR EN FORMATO

Verificar el sistema, error en el formato del mensaje.

31

APLICA DCC

Devuelve al POS información de tipo de cambio y moneda extranjera.

38

EXCEDE ING.DE PIN

Denegada, excede cantidad de reintentos de PIN permitidos.

43

RETENER TARJETA

Denegada, retener tarjeta.

45

NO OPERA EN CUOTAS

Denegada, tarjeta inhibida para operar en cuotas.

46

TARJETA NO VIGENTE

Denegada, la tarjeta no está vigente aún.

47

PIN REQUERIDO

Denegada, tarjeta requiere ingreso de PIN.

48

EXCEDE MAX. CUOTAS

Denegada, excede cantidad máxima de cuotas permitida.

49

ERROR FECHA VENCIM.

Verificar el sistema, error en formato de fecha de expiración (vto)

51

FONDOS INSUFICIENTES

Denegada, no posee fondos suficientes.

53

CUENTA INEXISTENTE

Denegada, no existe cuenta asociada.

54

TARJETA VENCIDA

Denegada, tarjeta expirada.

55

PIN INCORRECTO

Denegada, el código de identificación personal es incorrecto.

56

TARJ. NO HABILITADA

Denegada, emisor no habilitado en el sistema.

57

TRANS. NO PERMITIDA

Verificar el sistema, transacción no permitida a dicha tarjeta.

58

SERVICIO INVALIDO

Verificar el sistema, transacción no permitida a dicha terminal.

61

EXCEDE LIMITE

Denegada, excede el límite remanente de la tarjeta.

65

EXCEDE LIM. TARJETA

Denegada, excede el límite remanente de la tarjeta.

76

LLAMAR AL EMISOR

Solicitar autorización telefónica, en caso de ser aprobada, cargar el código obtenido y dejar la operación en OFFLINE.

77

ERROR PLAN / CUOTAS

Denegada, cantidad de cuotas inválida para el plan seleccionado.

85

APROBADA

Operación aprobada, emitir cupón (cargo o ticket).

89

TERMINAL INVALIDA

Denegada, número de terminal no habilitado por el Emisor.

91

EMISOR FUERA LINEA

Solicitar autorización telefónica, en caso de ser aprobada, cargar el código obtenido y dejar la operación en OFFLINE.

94

NRO. SEC. DUPLICAD

Denegada. Error en el mensaje. Envíe nuevamente la transacción incrementando en uno el system trace de la misma.

95

RE-TRANSMITIENDO

Diferencias en la conciliación del cierre, envíe Batch Upload.

96

ERROR EN SISTEMA

Mal funcionamiento del sistema. Solicitar autorización telefónica.

98

VER RECHAZO EN TICKET

Deben imprimir la información suministrada en el campo ISO 63.

xx

RECHAZADA (codnum)

Denegada, cualquier otro código no contemplado en tabla.