# Line

# 1. Procesar pago

POST /pagos

Permite procesar un pago.

REQUEST

  • provider: (Tipo de dato: string). Nombre del Servicio de Pagos ("line"). Campo obligatorio.

  • action: (Tipo de dato: string). Tipo de acción a ejecutar ("create"). Campo obligatorio.

  • public_key: (Tipo de dato: string) Apikey provista por Line. Campo obligatorio.

  • currency: (Tipo de dato: string). Tipo de moneda. Campo obligatorio.

  • installments: (Tipo de dato: integer). Cantidad de cuotas.. Campo obligatorio.

  • amount: (Tipo de dato: string). Monto a cobrar sin puntos ni decimales (Ejemplo: 1200). Campo obligatorio.

  • reference_id: (Tipo de dato: string). Id de la orden. Campo obligatorio.

  • id_site: (Tipo de dato: string).Número de comercio. Campo obligatorio.

  • card_doc_type: (Tipo de dato: string) Tipo de documento. Campo obligatorio.

  • card_doc_num: (Tipo de dato: string) Número de documento. Campo obligatorio.

  • card_number: (Tipo de dato: string) Número de tarjeta. Campo obligatorio.

  • exp_month: (Tipo de dato: string) Mes de expiración(ej: 03). Campo obligatorio.

  • exp_year: (Tipo de dato: string) año de expiración (ej: 25). Campo obligatorio.

  • sec_code: (Tipo de dato: string) Código de seguridad. Campo obligatorio.

  • card_brand: (Tipo de dato: string) Marca de la tarjeta (ej: VISA). Campo obligatorio.

  • card_type: (Tipo de dato: string) Tipo de tarjeta. Valores posibles CREDITO O DEBITO. Campo obligatorio.

  • card_name: (Tipo de dato: string) Nombre del titular. Campo obligatorio.

  • payer_email: (Tipo de dato: string) Email del usuario. Campo obligatorio.

  • installments: (Tipo de dato: string) Cantidad de cuotas. Campo obligatorio.

  • verification_mode: (Tipo de dato: string) Tipo de verificación (INMEDIATA o LARGOPLAZO:). Campo obligatorio.

  • time_unit: (Tipo de dato: string) indica qué unidad de tiempo se usa para expresar la validez del código o monto código utilizado para la verificación. Valores posibles (MINUTO, HORA, DIA) Campo obligatorio.

  • time_quantity: (Tipo de dato: string) Cantidad de tiempo disponible para verificar la compra. Campo obligatorio.

  • payer_id: (Tipo de dato: string) Identificador de comprador. Se recomienda que sea usuario logueado. Campo obligatorio.

  • verification_tag: (Tipo de dato: string) Texto que aparecerá en el resumen de cuenta del usuario al con el código verificador. Campo obligatorio.

  • ip_address: (Tipo de dato: string) IP del comprador. Campo obligatorio.

Los valores posibles son:

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", Debito_CABAL: "DEBITOCABAL", Electron_Banco_Frances: "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", Electron: "ELECTRON", Italcred: "ITALCRED", Kadicard: "KADICARD", La_Capital: "LACAPITAL", MAESTRO: "MAESTRO", Marcos_Juarez: "MJUAREZ", MASTER_Banco_Santa_Fe: "MASTERSTAFE", MASTER_Patagonia: "MASTERPATAGO", Mastercad_Nativa: "MASTERNATI", Mastercard_Banco_Cordoba: "MASTERCBA", Mastercard_Banco_Cordoba_Debito: "MASTERCBADEBIT", Mastercard_Banco_Frances: "MASTERBBVA", Mastercard_Banco_Santander: "MASTERRIO", Mastercard_Ciudad: "MASTERCDAD", Mastercard_COMAFI: "MASTERCOMAFI", Mastercard_Debit_Nacion: "MASTERDEBITNAC", Mastercard_Debit: "MASTERDEBIT", Mastercard_Dinosaurio: "MASTERDINO", Mastercard_ICBC: "MASTERICBC", Mastercard_Macro: "MASTERMACR", Mastercard_Nacion: "MASTERNAC", Mastercard: "MASTER", Nativa: "NATIVA", Nevada: "NEVADA", Plan_Platino: "PLAPLATINO", Tarjeta_Naranja: "NARANJA", Ultra: "ULTRA", Visa_Banco_Cordoba: "VISACBA", VISA_Banco_Frances: "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_Nacion: "VISANACION", VISA_Patagonia: "VISAPATAGO", VISA_Santander_Selecta: "VISARIOSEL", VISA_Santander: "VISARIO", VISA_ELECWEB: "VISA ELECWEB", VISA: "VISA", VYCARD: "VYCARD"

  • ambient:(Tipo de dato: string). Ambiente al que se apuntará. Valores posibles: developer o production. Campo obligatorio.
{
    "provider": "line",
    "action": "create",
    "public_key": "eb0872bebd934e1c94979f7476c68242",
    "site_id": "24719411",
    "card_doc_type": "DNI", 
    "amount": "1000", 
    "currency": "ARS",
    "card_number": "4507990000001026",
    "exp_month": "03",
    "exp_year": "25",
    "sec_code": "947",
    "card_brand": "VISA",
    "card_type": "CREDITO",
    "card_doc_num": "29946689",
    "card_name": "Andrés Jaromezuk",
    "payer_email": "andres,jaromezuk@pow.la",
    "reference_id": "45328",
    "installments": 1,
    "ambient": "developer",
    "verification_mode": "INMEDIATA",
    "time_unit": "HORA", 
    "time_quantity": "3", 
    "payer_id": "0819edf9-e833-4c17-83ef-fe2ae8f5b47e", 
    "verification_tag": "VERIFICACION",
    "ip_address": "181.168.15.171"
}

RESPONSE

  • IdentificadorCliente: Id único que identifica la transacción. Se utiliza para anular el pago o averiguar el estado.
{
    "Identificador": "0001488931",
    "IdentificadorCliente": "45329",
    "IdentificadorClienteOriginal": null,
    "Estado": "AUTORIZADA",
    "CodigoError": 0,
    "Mensaje": "AUTORIZADA",
    "MensajeFormato": "Transacción autorizada",
    "NumeroTarjeta": "450799******1026",
    "NumeroCuenta": "TEST",
    "ModoIngreso": "WEB",
    "VTEResult": "----",
    "CodigoEstado": "approved",
    "Detalle": [
        {
            "IdentificadorCliente": "45329",
            "IdentificadorClienteOriginal": "",
            "NumeroTarjeta": null,
            "NumeroCuenta": null,
            "Fecha": "2025-06-03T10:36:47.2415962-03:00",
            "Terminal": "72501520",
            "Lote": 583,
            "Cupon": 1367,
            "PlanCuotas": "0",
            "Cuotas": 1,
            "CodigoAutorizacion": "804874",
            "Estado": "AUTORIZADA",
            "TipoOperacion": "COMPRA",
            "CodigoError": 0,
            "CodigoEstado": "approved"
        }
    ],
    "IdentificadorSoftDescriptor": null,
    "CompraVerificada": null
}

# 2. Anulación/Devolución de pago

Se utiliza para anular un pago en su totalidad.

POST /pagos

REQUEST

  • provider: (Tipo de dato: string). Nombre del Servicio de Pagos ("line"). Campo obligatorio.

  • action: (Tipo de dato: string). Tipo de acción a ejecutar ("refund"). Campo obligatorio.

  • public_key: (Tipo de dato: string) Apikey provista por Line. Campo obligatorio.

  • payment_id: (Tipo de dato: string). Identificador del pago. Es el id devuelto al procesar un pago. Campo obligatorio.

  • ambient:(Tipo de dato: string). Ambiente al que se apuntará. Valores posibles: developer o production. Campo obligatorio.

{
    "provider": "line",
    "action": "refund",
    "public_key": "eb0872bebd934e1c94979f7476c68242",
    "payment_id":"453211",
    "ambient": "developer"
}

RESPONSE

  • CodigoEstado: Indica el status de la transacción. Si devuelve "approved", el pago está anulado.
{
    "Identificador": "0001488937",
    "IdentificadorCliente": "453211",
    "IdentificadorClienteOriginal": null,
    "Estado": "AUTORIZADA",
    "CodigoError": 0,
    "Mensaje": "AUTORIZADA",
    "MensajeFormato": "Transacción autorizada",
    "NumeroTarjeta": "450799******1026",
    "NumeroCuenta": "TEST",
    "ModoIngreso": "WEB",
    "VTEResult": "----",
    "CodigoEstado": "approved",
    "Detalle": [
        {
            "IdentificadorCliente": "453211",
            "IdentificadorClienteOriginal": "",
            "NumeroTarjeta": null,
            "NumeroCuenta": null,
            "Fecha": "2025-06-03T12:43:29.9216165-03:00",
            "Terminal": "72501520",
            "Lote": 639,
            "Cupon": 6077,
            "PlanCuotas": "0",
            "Cuotas": 1,
            "CodigoAutorizacion": "464366",
            "Estado": "AUTORIZADA",
            "TipoOperacion": "COMPRA",
            "CodigoError": 0,
            "CodigoEstado": "approved"
        }
    ],
    "IdentificadorSoftDescriptor": null,
    "CompraVerificada": null
}

# 3. Devolución parcial de pago

Se utiliza para hacer una devolución parcial de un pago.

POST /pagos

REQUEST

  • provider: (Tipo de dato: string). Nombre del Servicio de Pagos ("line"). Campo obligatorio.

  • action: (Tipo de dato: string). Tipo de acción a ejecutar ("refund"). Campo obligatorio.

  • public_key: (Tipo de dato: string) Apikey provista por Line. Campo obligatorio.

  • payment_id: (Tipo de dato: string). Identificador del pago. Es el id devuelto al procesar un pago. Campo obligatorio.

  • amount: (Tipo de dato: string). Monto a devolver. Campo obligatorio.

  • ambient:(Tipo de dato: string). Ambiente al que se apuntará. Valores posibles: developer o production. Campo obligatorio.

{
    "provider": "line",
    "action": "refund",
    "public_key": "eb0872bebd934e1c94979f7476c68242",
    "payment_id":"453211",
    "ambient": "developer"
    "amount":"300"
}

RESPONSE

  • Detalle.TipoOperacion: Indica el status en detalle de la transacción
{
    "Identificador": "0001488937",
    "IdentificadorCliente": "453211",
    "IdentificadorClienteOriginal": "453211",
    "Estado": "ANULADA",
    "CodigoError": 0,
    "Mensaje": "AUTORIZADA",
    "MensajeFormato": "AUTORIZADA",
    "NumeroTarjeta": "450799******1026",
    "NumeroCuenta": "TEST",
    "ModoIngreso": "WEB",
    "VTEResult": "----",
    "CodigoEstado": "approved",
    "Detalle": [
        {
            "IdentificadorCliente": "453211-A01",
            "IdentificadorClienteOriginal": "453211",
            "NumeroTarjeta": null,
            "NumeroCuenta": null,
            "Fecha": "2025-06-03T12:44:03.7981026-03:00",
            "Terminal": "72501520",
            "Lote": 83,
            "Cupon": 3895,
            "PlanCuotas": "0",
            "Cuotas": 1,
            "CodigoAutorizacion": "464366",
            "Estado": "AUTORIZADA",
            "TipoOperacion": "ANULACION",
            "CodigoError": 0,
            "CodigoEstado": "approved"
        }
    ],
    "IdentificadorSoftDescriptor": null,
    "CompraVerificada": null
}

# 4. Obtener detalles de un pago

Obtiene los detalles de un pago.

POST /pagos

REQUEST

  • provider: (Tipo de dato: string). Nombre del Servicio de Pagos ("line"). Campo obligatorio.

  • action: (Tipo de dato: string). Tipo de acción a ejecutar ("obtain_payment_info"). Campo obligatorio.

  • public_key: (Tipo de dato: string) Apikey provista por Line. Campo obligatorio.

  • payment_id: (Tipo de dato: string). Identificador del pago. Es el id devuelto al procesar un pago. Campo obligatorio.

  • ambient:(Tipo de dato: string). Ambiente al que se apuntará. Valores posibles: developer o production. Campo obligatorio.

{
    "provider": "line",
    "action": "obtain_payment_info",
    "public_key": "eb0872bebd934e1c94979f7476c68242",
    "payment_id":"45327",
    "ambient": "developer"
}

RESPONSE

  • Identificador: Id del pago que se ingresó en el request.

  • CodigoEstado: Status del pago.

{
    "CodigoCliente": "TESTCCS",
    "Identificador": "45327",
    "TipoOperacion": "COMPRA",
    "Fecha": "2025-06-03T09:57:50.12",
    "CanalVenta": "WEB",
    "TerminalSistema": "45327",
    "TerminalTipo": "VIRTUAL",
    "Estado": "AUTORIZADA",
    "CodigoEstado": "approved",
    "Mensaje": "AUTORIZADA",
    "CodigoEmisor": "VISA",
    "Referencia": "",
    "Autorizaciones": [
        {
            "TipoOperacion": "COMPRA",
            "Fecha": "2025-06-03T09:57:50.12",
            "ModoIngreso": "WEB",
            "Emisor": "VISA",
            "Moneda": "ARS",
            "Importe": 1000,
            "Tarjeta": "450799******1026",
            "Cuotas": 1,
            "Referencia": "",
            "Identificador": "45327",
            "IdentificadorOriginal": "",
            "Terminal": "72501520",
            "Estado": "AUTORIZADA",
            "Lote": 683,
            "Cupon": 9228,
            "Trace": 685991,
            "TraceOriginal": 0,
            "PlanCuotas": "0",
            "FechaHost": "2025-06-03T09:57:50.133",
            "CodigoRespuesta": 0,
            "CodigoAutorizacion": "198537",
            "RetReference": "000000000531196",
            "CodigoEstado": "approved",
            "MensajeRespuesta": "",
            "MensajeImprimir": "AUTORIZADA",
            "TXDate": "0603",
            "TXTime": "095750",
            "CierreLoteID": 0,
            "CierreLoteDetalleID": 0,
            "HostAutorizador": "PRISMAVISA",
            "NumeroComercio": "24719411",
            "Agregador": null
        }
    ],
    "Anulaciones": [],
    "IPAddress": ""
}

# 5. Reverso técnico

Anula una transacción en caso de error.

POST /pagos

REQUEST

  • provider: (Tipo de dato: string). Nombre del Servicio de Pagos ("line"). Campo obligatorio.

  • action: (Tipo de dato: string). Tipo de acción a ejecutar ("reverso_tecnico"). Campo obligatorio.

  • public_key: (Tipo de dato: string) Apikey provista por Line. Campo obligatorio.

  • payment_id: (Tipo de dato: string). Identificador del pago. Es el id devuelto al procesar un pago. Campo obligatorio.

  • ambient:(Tipo de dato: string). Ambiente al que se apuntará. Valores posibles: developer o production. Campo obligatorio.

{
    "provider": "line",
    "action": "reverso_tecnico",
    "public_key": "eb0872bebd934e1c94979f7476c68242",
    "payment_id":"45329",
    "ambient": "developer"
}

RESPONSE

  • Identificador: Id del pago que se ingresó en el request.

  • CodigoEstado: Status del pago.

{
    "Identificador": "0001488931",
    "IdentificadorCliente": "45329",
    "IdentificadorClienteOriginal": "45329",
    "Estado": "ANULADA",
    "CodigoError": 0,
    "Mensaje": "AUTORIZADA",
    "MensajeFormato": "AUTORIZADA",
    "NumeroTarjeta": "450799******1026",
    "NumeroCuenta": "TEST",
    "ModoIngreso": "WEB",
    "VTEResult": "----",
    "CodigoEstado": "approved",
    "Detalle": [
        {
            "IdentificadorCliente": "45329",
            "IdentificadorClienteOriginal": "",
            "NumeroTarjeta": null,
            "NumeroCuenta": null,
            "Fecha": "2025-06-03T10:36:46.85",
            "Terminal": "72501520",
            "Lote": 583,
            "Cupon": 1367,
            "PlanCuotas": "0",
            "Cuotas": 1,
            "CodigoAutorizacion": "804874",
            "Estado": "ANULADA",
            "TipoOperacion": "COMPRA",
            "CodigoError": 0,
            "CodigoEstado": "approved"
        }
    ],
    "IdentificadorSoftDescriptor": null,
    "CompraVerificada": null
}