Skip to main content

Solicitud de cobro con Split Payment

Conceptos Generales​

El resultado de esta solicitud es el mismo de Solicitud de Cobro la diferencia es que en los datos de entrada se pueden especificar distintos usuarios de Zenrise que recibirán un determinado monto del pago una vez acreditado.

Crear una solicitud de cobro​

URL: /v1/requests/simple/split

Método: POST

Requiere Auth: Sí, ver Autenticación

Request Payload:

{
  "amount": 1000,
  "contact": {
    "email": "string",
    "externalReference": "string",
    "firstName": "string",
    "lastName": "string",
    "holderDocumentNumber":"string", //opcional
    "documentType":"string" // opcional CUIT o DNI
  },
  "description": "string",
  "externalReference": "string",
  "firstDueDate": "2020-06-25",
  "percentageAfterFirstDueDate": 0,
  "percentageAfterSecondDueDate": 0,
  "amountAfterFirstDueDate": 0, // OPCIONAL, recargo de monto fijo tras el primer vencimiento
  "amountAfterSecondDueDate": 0, // OPCIONAL, recargo de monto fijo tras el segundo vencimiento
  "secondDueDate": "2020-06-25",
  "sendPerEmail": true,
  "paymentMethods": [ 1, 2, 9, 21, 25 ], // OPCIONAL por defecto están todos
  "qrEnabled": true, // OPCIONAL, default true
  "debinEnabled": true, // OPCIONAL, default true
  "backUrl":{ // OPCIONAL
    "success":"https://url-de-exito.com",
    "failure":"https://url-de-fallo.com"
  },
  "ahora12Enable":false, // OPCIONAL
  "ahora12Treatment": null, // OPCIONAL, obligatorio si ahora12Enable = true
  "ahora12AvailableInstallments": null, // OPCIONAL (string separado por comas si ahora12Enable = true, ej: "3,6,12,18,24")
  "partnersFee": [
    {
      "organizationHash": "shdnJfk2",
      "feeAmount":200
    }
  ]
}

Detalles importantes del Payload:

paymentMethods

  • 1 -> Pago Facil
  • 2 -> Rapipago
  • 9 -> Tridi (Transferencia identificada)
  • 21 -> Pago Mis Cuentas
  • 25 -> Link Pagos
  • 34 -> QR
  • 98 -> Solo tarjeta de débito
  • 99 -> Solo tarjeta de crédito
  • 100 -> Tarjetas

Importante — los códigos no funcionan todos igual:

  • Medios aditivos (1, 2, 9, 21, 25, 34): no son excluyentes. Indican de qué medios querés obtener la referencia de pago en la respuesta (código de barras de Pago Fácil/Rapipago, referencia de Pago Mis Cuentas, Link y la cadena de QR). No deshabilitan ningún otro medio, y el pago con tarjeta (checkoutLink) se genera siempre. Por ejemplo, enviar [34] (QR) agrega qrString a la respuesta, pero no impide pagar con tarjeta ni oculta los demás medios.
  • Pseudo-medios de tarjeta (98, 99, 100): sí restringen lo que ve el pagador en el checkout:
    • 98 (solo tarjeta de débito): limita la tarjeta a débito (oculta la tarjeta de crédito). No afecta al DEBIN ni al QR.
    • 99 (solo tarjeta de crédito): deja únicamente la tarjeta de crédito (oculta la tarjeta de débito, el DEBIN y el QR).
    • 100 (solo tarjetas): habilita tarjeta de débito y de crédito, y oculta el DEBIN y el QR.

No se recomienda combinar un pseudo-medio (98/99/100) con medios aditivos, ni enviar más de un pseudo-medio a la vez (son configuraciones de tarjeta contradictorias entre sí). Enviá, como máximo, uno de 98/99/100, o una lista de medios aditivos.

El DEBIN no se solicita a través de paymentMethods. Se controla con el campo opcional debinEnabled del body (true/false, por defecto true). De forma análoga, qrEnabled (por defecto true) controla la opción de pago con QR en el checkout.

contact: La entidad contact es la persona pagadora, siendo obligatoria una de estas opciones:

  • email
  • 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 documento identificatorio del contacto. Si es enviado, se debe enviar también documentType. documentType El tipo de documento del contacto, admite dos valores posibles: DNI o 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 ese externalReference para la empresa, si existe usará el mismo, si no lo creará. Valores comunes que se utilizan son: 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 enviará 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.

ahora12Enable Con este valor puede indicar si la solicitud de cobro tiene habilitado o no pagar con los planes ahora 12 habilitados para el comercio.

ahora12Treatment Con este valor podemos indicar quién de las partes absorbe el interés financiero del plan ahora 12, los valores posibles son ADMIN y CLIENT. ADMIN: El dueño de la cuenta absorbe el interés. CLIENT: El cliente absorbe el interés.

ahora12AvailableInstallments Con este valor podemos indicar en cuántas cuotas se puede pagar la solicitud de cobro. Es un string con los valores separados por comas (ej: "3,6,12,18,24"). Si se necesita que el link muestre solo 12 y 18 cuotas se debe enviar "12,18".

partnersFee Array de objetos que contiene el hash identificador de la organización y el monto que esta organización recibirá una vez que se acredite el pago.

Request Response:

{
    "amount": 500.0,
    "couponLink": "https://render.zenrise.io/zen/requests-pdf/d/Nnz7lQ2gLl",
    "requestId": 28606,
    "invoiceId": 451820,
    "contact": {
        "id": 15295,
        "username": "fioritonicolas.15295",
        "fullName": "Fiorito, Nicolas",
        "password": "fioritonicolas.15295",
        "email": "nicolas@zenrise.io",
        "externalReference": "83"
    },
    "checkoutLink": "http://dev.checkout.zenrise.io?token=52039775-4ab1-4741-826a-bff113c834db"
}

Detalles importantes del Response:

couponLink y checkoutLink son los dos campos más 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.

Al igual que en la solicitud de cobro simple, la respuesta también incluye barcodePagoFacil, barcodeRapipago, pmcPaymentReference, linkPagoPaymentReference (según los paymentMethods enviados), cardTransactionRequestId (siempre) y qrString (solo si se envió el 34).