Solicitud pago

Genera una nueva operación en el sistema, solamente puede utilizar este método para generar operaciones que no sean de tarjeta de crédito ni débito.

Parámetros recibidos

Nombre Tipo Descripción
version Texto Versión, valor fijo “2.0”
tipo_operacion Set Tipo de la operación. Valor fijo “op_pago”
credenciales Estructura DatosCredenciales Los datos de las credenciales
operacion Estructura DatosOperacionPago Los datos de la operación a realizar
fp Array de estructura FormaPago Los datos de las formas de pago
convenio Numérico entero El número de convenio asignado por ePagos


DatosCredenciales
Nombre Tipo Descripción
id_organismo Numérico entero Código de organismo
token Texto El token


DatosOperacionPago
Nombre Tipo Descripción
numero_operacion Texto (100) Opcional. Código externo del cliente. Le permite relacionar un pago con sus transacciones
identificador_externo_2 Texto (100) Opcional. Identificador adicional para uso del cliente.
identificador_externo_3 Texto (512) Opcional. Identificador adicional para uso del cliente.
identificador_externo_4 Texto (65.535) Opcional. Identificador adicional para uso del cliente.
identificador_cliente Texto Opcional. Identificador para usar luego en los métodos de recurrencia.
id_moneda_operacion Numérico entero El código de moneda, valor fijo “1”
monto_operacion Numérico decimal El importe de la operación, con dos decimales
opc_pdf Booleano Opcional. Determina si en la respuesta se incluye el PDF del comprobante para el pago (codificado como base 64). Por defecto: true
opc_fecha_vencimiento Fecha (AAAA-MM-DD) Opcional. La fecha de vencimiento de la boleta, para los pagos presenciales
opc_devolver_qr Booleano Opcional. Determina si se devuelve la imagen del QR. Por defecto: false
opc_devolver_codbarras Booleano Opcional. Determina si se devuelve la imagen del código de barras. Por defecto: false
opc_generar_pdf Booleano Opcional. Determina si se genera la boleta en pdf de la operación. No generarla acelera el procesamiento en los casos de emisiones masivas. Por defecto: true
detalle_operacion Estructura DetalleOperacion Los detalles o ítems que componen el importe de la operación
pagador Array de estructura Pagador Los datos del pagador de la operación
fecha_2do_venc Fecha (AAAA-MM-DD) Opcional. La fecha de del segundo vencimiento de la boleta.
monto_operacion_2do_venc Numérico decimal Opcional. El importe del segundo vencimiento de la operación, con dos decimales.
tipo_operacion Numérico entero Opcional. El tipo de deuda para agrupar la deuda. Consultar a su implementador para ver los valores posibles
codigo_publicacion Numérico entero (8 dígitos) Opcional. El código de publicación de homebanking, sino se usa el valor del cuit del Pagador
url_boleta Texto (256) Opcional. URL donde se aloja la boleta para enviar al usuario
opc_T30_cerrado Nuevo Booleano Opcional. Determina si el QR interoperable es cerrado o abierto. Es decir, si el usuario puede ingresar el monto a pagar. Por defecto: true
opc_T30_reutilizable Nuevo Booleano Opcional. Determina si el QR interoperable se puede pagar más de una vez. Por defecto: false
opc_T30_requiere_orden Nuevo Booleano Opcional. Determina si el QR interoperable solo se puede pagar mediante una orden de pago generada previamente que se consume con cada pago. Solo se permite en QRs cerrados. Por defecto: false


DetalleOperacion
Nombre Tipo Descripción
id_item Numérico entero El código o número de ítem
desc_item Texto El texto a mostrar al usuario sobre el ítem
monto_item Numérico decimal El importe del ítem (la suma por la cantidad debe ser igual al monto de la operación)
cantidad_item Numérico entero La cantidad de estos ítems


Pagador
Nombre Tipo Descripción
nombre_pagador Texto Opcional. El nombre del pagador
apellido_pagador Texto Opcional. El apellido del pagador
fechanac_pagador Texto Opcional. La fecha de nacimiento del pagador (AAAA-MM-DD)
email_pagador Texto La dirección de email del pagador
identificacion_pagador Estructura PagadorIdentificacion La identificación del pagador
domicilio_pagador Estructura PagadorDomicilio Opcional. La información del domicilio del pagador
telefono_pagador Estructura PagadorTelefono Opcional. La información del teléfono del pagador
cbu_pagador Numérico entero El número de CBU del banco del pagador, usado cuando la forma de pago es DEBIN


PagadorIdentificacion
Nombre Tipo Descripción
tipo_doc_pagador Numérico entero El tipo de documento del pagador. Ver tabla documentos
numero_doc_pagador Numérico entero El número de documento del pagador
cuit_doc_pagador Numérico entero El número de cuit del pagador


PagadorDomicilio
Nombre Tipo Descripción
calle_dom_pagador Texto El nombre de la calle del pagador
numero_dom_pagador Texto El número de la calle del pagador
adicional_dom_pagador Texto El adicional de la calle del pagador
cp_dom_pagador Texto El código postal del domicilio del pagador
ciudad_dom_pagador Texto La ciudad del domicilio del pagador
provincia_dom_pagador Numérico entero El código de la provincia del domicilio del pagador. Ver tabla provincias
país_dom_pagador Numérico entero El código de país del domicilio del pagador. Valor fijo en 13 (Argentina)


PagadorTelefono
Nombre Tipo Descripción
codigo_telef_pagador Numérico entero El código de área del teléfono del pagador
numero_telef_pagador Numérico entero El número de teléfono del pagador


FormaPago
Nombre Tipo Descripción
id_fp Numérico entero Código de la forma de pago
monto_fp Numérico decimal El importe de la forma de pago
tarjeta Estructura FormaPagoTarjeta La estructura de forma de pago. Es obligatoria solo si la forma de pago es tarjeta de crédito o débito.


FormaPagoTarjeta
Nombre Tipo Descripción
numero_tarjeta_fp Numérico entero El número de tarjeta de crédito
banco_tarjeta_fp Texto El nombre del banco emisor de la tarjeta
vencimiento_tarjeta_fp Estructura FormaPagoTarjetaVencimiento Fecha de vencimiento
codigo_seg_tarjeta_fp Texto Código de seguridad de la tarjeta
cuotas_tarjeta_fp Numérico entero La cantidad de cuotas a realizar
titular_tarjeta_fp Texto El nombre y apellido como aparece en la tarjeta
identificación_tarjeta_fp Estructura FormaPagoTarjetaIdentificacion La identificación del titular de la tarjeta
fechanac_tarjeta_fp Fecha La fecha de nacimiento del titular de la tarjeta (AAAA-MM-DD)
direccion_tarjeta_fp Estructura FormaPagoTarjetaDireccion La dirección del titular de la tarjeta (donde se envía el resumen)


FormaPagoTarjetaIdentificacion
Nombre Tipo Descripción
tipo_identificacion_tarjeta_fp Numérico entero El tipo de identificación del titular de la tarjeta. Ver tabla documentos
numero_identificacion_tarjeta_fp Numérico entero El número de identificación del titular de la tarjeta


FormaPagoTarjetaDireccion
Nombre Tipo Descripción
calle_direccion_tarjeta_fp Texto La calle de la dirección del titular de la tarjeta
numero_direccion_tarjeta_fp Texto El número de la dirección del titular de la tarjeta


FormaPagoTarjetaVencimiento
Nombre Tipo Descripción
mes_vencimiento_tarjeta_fp Numérico entero El mes de vencimiento de la tarjeta (MM)
anio_vencimiento_tarjeta_fp Numérico entero El año de vencimiento de la tarjeta (AAAA)

Los campos de tipo float, se envían sin separadores de miles y con el punto (.) como separador decimal. Por ejemplo: 1234.12
Si el número a enviar es un entero puede enviarse sin el .00 correspondiente. Por ejemplo: 123 o 123.00

Respuesta

Nombre Tipo Descripción
id_resp Numérico entero El código de respuesta
respuesta Texto La descripción de la respuesta
token Texto El token único generado para la solicitud
id_transaccion Numérico entero Es el código único de operación que le asigna ePagos para identificarla en la plataforma
id_organismo Numérico entero Su número de organismo proporcionado por ePagos
convenio Numérico entero El número de convenio proporcionado por ePagos
numero_operacion Numérico entero El número interno de operación de informó al iniciar la solicitud
fp Array de estructura Estructura RespuestaFormaPago


RespuestaFormaPago
Nombre Tipo Descripción
codigo_pago_fp Numérico entero Si es un pago en efectivo (presencial) o de Homebanking, devuelve el código corto que identifica el pago
codigo_barras_fp Texto El código de barras completo que identifica el pago
fechavenc_fp Fecha La fecha de vencimiento para el pago de la operación (AAAA-MM-DD)
importe_fp Numérico decimal El importe de la operación generada
pdf Base64 El contenido del comprobante para el pago de la operación. En formato PDF, si se envía el campo opcional opc_pdf en falso entonces el texto que se devolverá en este campo no se debe tener en cuenta
codigo_barras_imagen Base64 El contenido del código de barras como imagen para usar directamente. En formato PNG. Solo se devuelve si se envía el campo opcional opc_devolver_codbarras en true.
qr_imagen Base64 El contenido del código QR para el pago de la obligación. En formato PNG. Solo se devuelve si se envía el campo opcional opc_devolver_qr en true.
qr_imagen_T30 Base64 El contenido del código QR para el pago de la obligación de transferencias 3.0. En formato PNG. Solo se devuelve si se envía el campo opcional opc_devolver_qr en true.
qr_texto_T30 Texto El texto contenido del código QR para el pago de la obligación de transferencias 3.0.
respuesta_entidad_cobro Texto El detalle de la respuesta del medio de pago elegido. Puede no estar disponible de acuerdo al medio de pago seleccionado.
codigo_pmc Texto El código de publicación de la deuda en Pago Mis Cuentas
codigo_link Texto El código de publicación de la deuda en Red Link
url_qr Texto Devuelve la URL a usar para el pago en línea (tarjeta de crédito y/o débito de la operación)
cuit_cuenta Numérico entero El número de CUIT de la cuenta
cbu_cuenta Texto El número de CBU/CVU o alias de la cuenta de destino del DEBIN
barras_adicionales Nuevo Array de estructura Estructura BarrasAdicionales


BarrasAdicionales
Nombre Tipo Descripción
codigo_barra Texto El código de barra adicional de la operación
codigo de pago Texto El código de pago sin factura asociado a la barra adicional de la operación
fechavenc Fecha La fecha de vencimiento para el pago de la barra adicional de la operación (AAAA-MM-DD)
importe Numérico decimal El importe de la barra adicional de la operación


Respuestas posibles

id_resp Tipo Respuesta
02001 Correcta Pago acreditado
02002 Correcta Pago pendiente
02003 Error Error al validar el token
02004 Error Pago cancelado / rechazado
02005 Error Error interno al intentar procesar el pago
02006 Error Error al validar el parámetro: [_parametro_]
02007 Error El usuario canceló el pago
02008 Error No coinciden los montos y los detalles
02009 Error La forma de pago [_parametro_] no se encuentra disponible
02010 Error Versión inválida del protocolo