Como realizar un pago de servipago

Empezar

Recaudos servipagos

Esta categoría tiene consulta formulario, consulta datos transacción y pago.

Consulta – Datos de la transacción servipagos

Al consultar un recaudo, el sistema devuelve un objeto con los datos obtenidos.
Estos campos vienen en la propiedad value.item y contienen información del cliente, operación, valores y comisión.
Todos los campos de esta sección son informativos (disabled: "true").

{
  "name": "servipagos",
  "origin": "object",
  "payloadSell": true,
  "label": "Cuenta",
  "type": "input-query-servipagos",
  "value": {
    "item": [
      {
        "title": "Nombre cliente",
        "valor": "VELASTEGUI FARINANGO ALEJANDRO LENIN",
        "id": "2",
        "disabled": "true"
      },
      {
        "title": "Valor a pagar",
        "valor": "73.87",
        "id": "12",
        "disabled": "true"
      },
      {
        "title": "Comisión",
        "valor": "0.00",
        "id": "comision",
        "disabled": "true"
      }
    ]
  },
  "disabled": true
}

Pago – Escenario 1: Abono parcial

Si el campo val viene con "disabled": false, el cliente puede editarlo y pagar un valor distinto al total.
En este caso, puede ingresar un monto menor al valor original (ejemplo: pagar 50 en lugar de 73.87).

Pago – Escenario 2: Pago completo

Si el campo val viene con "disabled": true, significa que el cliente no puede modificarlo y debe pagar el valor completo.

{
  "label": "Valor",
  "name": "val",
  "value": "73.87",
  "disabled": true
},
{
  "name": "recharge",
  "label": "Comision",
  "value": "0.00",
  "disabled": true
},
{
  "name": "amount",
  "label": "Total a Pagar",
  "value": "73.87",
  "disabled": true
}

Realizar pago del recaudo.

Estructura de envío – form, servipagos y montos

Al realizar el pago se deben enviar dos bloques de datos y tres valores numéricos:
form
Es un JSON parseado a string que contiene exclusivamente lo que el cliente llenó en el formulario (nombre del campo, id, tipo, label y el valor ingresado).
Ejemplo (string):

[{\"name\":\"Identificación_Cartera\",\"id\":\"1\",\"type\":\"A\",\"label\":\"Código Cartera\",\"valor\":\"35435345\",\"service_number\":true},{\"name\":\"Nombre_Depositante\",\"id\":\"3\",\"type\":\"C\",\"label\":\"Depositante\",\"valor\":\"dfgdfgdf\",\"service_number\":false},{\"name\":\"Tipo_Identificacion\",\"id\":\"4\",\"type\":\"A\",\"label\":\"Tipo de Documento\",\"valor\":\"C\",\"service_number\":false},{\"name\":\"C.I./RUC/Pasaporte\",\"id\":\"5\",\"type\":\"A\",\"label\":\"C.I./RUC/Pasaporte\",\"valor\":\"32534534543\",\"service_number\":false}]"

servipagos
Contiene los datos informativos de la consulta previa (resultado del “Consultar datos del recaudo”).
Se recomienda enviarlo como objeto (o como string si tu integración lo requiere).
Ejemplo (objeto reducido):

{
  "item": [
      { "title": "Nombre cliente", "valor": "VELASTEGUI FARINANGO ALEJANDRO LENIN", "id": "2", "disabled": "true" },
    { "title": "Valor a pagar",   "valor": "73.87",                                   "id": "12","disabled": "true" },
    { "title": "Comisión",        
        "valor": "0.00",                                    
        "id": "comision", 
        "disabled":"true" 
     }
  ]
}

Montos que se envían por separado

Además de form y servipagos, se deben enviar tres valores sueltos (no dentro de form), porque el total puede variar si el usuario edita el valor:

valor: importe base que el cliente decide pagar (puede ser el total o un abono).

tip: comisión aplicada a la transacción.

val: valor total a cobrar = valor + tip.

Si el usuario modifica valor, entonces val debe recalcularse en tu frontend antes de enviar.

 {
  "productId": 10048870,
  "customerDocument": "35435345",
  "form": "[...]",
  "servipagos": { "item": [...] },
  "valor": "73.87",
  "tip":   "0.00",
  "val":   "73.87"
}

Reglas de negocio

form siempre va stringificado (JSON a string) con lo que ingresó el cliente.

servipagos representa la consulta previa (datos informativos con disabled: "true").

Enviar por separado valor, tip y val para evitar inconsistencias si el monto editable cambia.

val = parseFloat(valor) + parseFloat(tip) (redondeado a 2 decimales).

customerDocument se toma del campo que en form/definición tenga service_number: true.

Recibo:

Los recibos debe entregarse en el siguiente formato, la información de la transacción con los datos se podran consultar en la api transaction/get:
https://bemovil.net/bill/b476e284-1de2-45e7-beb8-d27ac1d025a0

Como realizar un pago de servipago

Empezar#

Empezar