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,
  "secondDueDate": "2020-06-25",
  "sendPerEmail": true,
  "paymentMethods": [ 1, 2, 9, 21, 25 ], // OPCIONAL por defecto están todos
  "backUrl":{ // OPCIONAL
    "success":"https://url-de-exito.com",
    "failure":"https://url-de-fallo.com"
  },
  "ahora12Enable":false, // OPCIONAL
  "ahora12Treatment": null, // OPCIONAL, obligatorio si ahora12Enable = true
  "ahora12Installments": null, // OPCIONAL, obligatorio si ahora12Enable = true [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
  • 35 -> Debin
  • 99 -> Tarjetas

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.

ahora12Installments Con este valor podemos indicar en cuántas cuotas se puede pagar la solicitud de cobro, es un arreglo que recibe los valores 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.