Solicitud de cobro
Conceptos Generales
Las solicitudes de cobro son unas de las formas mas simples de cobrar a un cliente dentro de Zenrise. Toma como parámetro los datos del cliente, montos y fechas de vencimiento y genera 2 link principales:
- Link de pago con tarjeta
- Cupón de pago para rapipago y pagofacil
Estos links pueden ser enviados al email del cliente en este mismo proceso.
Importante! Ambos links estarán relacionados al cliente que se uso para generar la solicitud, es decir cuando el pago sea exitoso ese pago entrará a nombre del cliente cargado en la solicitud de cobro.
Crear una solicitud de cobro
URL: /v1/requests/simple
Metodo: POST
Requiere Auth: Si, ver Autenticación
Request Payload:
Detalle importantes del Payload:
paymentMethods
- 1 -> Pago Facil
- 2 -> Rapipago
- 9 -> Tridi (Transferencia identificada)
- 21 -> Pago Mis Cuentas
- 25 -> Link Pagos
- 34 -> QR
- 35 -> Debin
contact: La entidad contact es la persona pagadora, siendo obligatorio una de estas opciones:
- externalReference
- firstName y lastName
Además se pueden enviar los datos de identificación del contacto para matcheo de pagos por TRI-DI.
holderDocumentNumber El número de de documento identificatorio del contacto si es enviado de se debe enviar documentType documentType El tipo de documento del contacto admite dos valores posibles. DNI ó CUIT.
El campo externalReference dentro de contacto se usa para identificar inequívocamente al mismo y sincronizar con el sistema de origen de esta operación. La API de Zenrise buscará si ya existe un contacto con es externalReference para la empresa, si existe usará el mismo si no lo creará. Valores comunes que se utilizan ID, DNI, CUIT, etc.
externalReference Este campo es el ID de la solicitud es lo que identifica inequívocamente esta transacción para la empresa. Valores comunes son: ID, Nro. de Factura, Nro. de Transacción.
sendPerEmail Puede ser true o false, dependiendo de ese valor Zenrise enviara por email al cliente los links de cobro.
backUrl De manera opcional puede configurar nuestra pantalla de checkout para que luego de éxito o falla redirija a una URL que usted nos pase.
percentageAfterFirstDueDate y percentageAfterSecondDueDate son los porcentajes de recargo que se aplicarán a la deuda si el pago es realizado después de la fecha de vencimiento.
amountAfterFirstDueDate y amountAfterSecondDueDate son los montos fijos de recargo que se aplicarán a la deuda si el pago es realizado después de la fecha de vencimiento.
Request Response:
Detalle importantes del Response:
couponLink y checkoutLink son los dos campos mas importantes de esta response ya que representan el pdf con los datos de pago (para rapipago, pagofácil) y el link para pago con tarjeta.
barcodePagoFacil y barcodeRapipago son los links para generar el código de barras para rapipago y pagofacil.
pmcPaymentReference y linkPagoPaymentReference son los campos que identifican inequívocamente la solicitud de cobro para los medios de pago Pago Mis Cuentas y Link Pagos.
invoiceId es el ID de la factura generada para esta solicitud de cobro.
Tener en cuenta: La respuesta de barcodePagoFacil, barcodeRapipago, pmcPaymentReference y linkPagoPaymentReference solo se generan si el medio de pago esta incluido en la lista de paymentMethods o si la misma viene vacía.