La presente documentación corresponde a Line API Rest.
Aclaraciones generales aplicable para todas las modalidades de utilización de la API de Line:
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 |
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.
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.
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. |
Obtiene las autorizaciones de una operación según un identificador.
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 |
GET api/v1/creditcard/autorizaciontx/2607E530-92CB-02EA-DC87-EE01436C4862
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 |
Realiza las autorizaciones de una operación.
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 |
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"
} ]
}
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 |
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"
}
}
]
}
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",
}
]
}
Realiza la anulación/devolución de una operación.
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
POST api/v1/creditcard/anulacion/347bc7d7-6854-44b9-aec3-4a947fac71bf
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 |
Realiza la anulación/devolución parcial de una operación.
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
POST api/v1/creditcard/anulacion/458bc8d7-6854-66b9-bfd4-4a058fac82bf/2765.20
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 |
Realiza el reverso de una operación.
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
POST api/v1/creditcard/reverso/458bc8d7-6854-66b9-bfd4-4a058fac82bf
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 |
Obtiene los emisores disponibles por canal de venta.
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. |
GET api/v1/creditcard/emisores/PDV
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 |
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
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. |
GET api/v2/creditcard/emisores/PDV/VISA
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 |
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
Parámetros URI
No lleva parámetros.
GET api/v2/creditcard/comercios
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 |
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
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 |
GET api/v1/creditcard/comercios/WEB/10666292
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 |
Obtiene el estado de las conexiones.
Parámetros URI
No lleva parámetros
GET api/v1/creditcard/conexiones/estado
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 |
Obtiene el estado de una conexión en particular.
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 |
GET api/v1/creditcard/conexiones/estado/AMEX
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 |
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. |
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
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. |
GET api/v2/presente/autorizaciontx/458bc8d7-6854-66b9-bfd4-4a058fac82bf
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 |
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
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 |
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": [],
}
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": [],
}
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": [],
}
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 |
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
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 |
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": [],
}
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": [],
}
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": [],
}
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 |
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
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 |
application/json, text/json
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 |
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
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. |
GET api/v2/presente/emisores/PDV
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 |
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
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. |
GET api/v2/presente/emisores/WEB/VISA
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 |
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
Parámetros URI
No lleva parámetros
GET api/v2/presente/comercios
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 |
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
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 |
GET api/v2/presente/comercios/WEB/10789292
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 |
Obtiene el estado de las conexiones.
Parámetros URI
No lleva parámetros
GET api/v2/presente/conexiones/estado
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 |
Obtiene el estado de una conexión en particular.
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 |
GET api/v2/presente/conexiones/estado/PRISMAVISA
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 |
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 |
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
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 |
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",
}
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 |
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
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. |
application/json, text/json
{
"IdentificadorCliente": "JUSK373636E43",
"Moneda": "ARS",
"Token": "347bc7d7-6854-44b9-aec3-4a947fac71bf",
"Referencia": "Cuota Enero 2018",
"NumeroComercio": "40873",
"Importe": 6708.27
}
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 |
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
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.
POST api/v1/recurrente/anulacion/MSG66524YHD
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 |
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 |
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
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 |
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",
}
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 |
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
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.
POST api/v2/preautorizacion/captura/A78DB8B2-34BE-5CFB-477E-627D8A97EC2E/JPS74S67A20S/2300.50
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 |
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
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.
POST api/v2/preautorizacion/anulacion/JL666S00AS99
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 |
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
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.
POST api/v2/preautorizacion/anulacion/SAS196708CG/1200.00
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 |
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 |
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. |