Código QR y pagoáneo

En el viaje de Código QR y pago instantáneo, Yuno presenta un único código QR que cobra al cliente inmediatamente y lo inscribe en todos los pagos recurrentes futuros en un solo paso. Cuando el cliente escanea el QR, su aplicación bancaria procesa el primer pago y captura simultáneamente su consentimiento para los cargos automáticos posteriores, eliminando la necesidad de aprobaciones adicionales o entradas manuales.

Tras el escaneado y el pago iniciales, cada pedido posterior es enviado por el comerciante a través de Yuno y validado automáticamente por el banco del cliente con el consentimiento original, garantizando transferencias rápidas y fiables sin más interacción con el cliente. Este flujo maximiza la conversión y simplifica la gestión de la suscripción al combinar la inscripción y el pago en una sola acción del usuario.

Paso 1: Primer pago y creación de la suscripción

Para iniciar el flujo, debes partir de una norma Pix pago que también configura la suscripción. Esto genera un código QR o una pantalla de redirección para que el cliente autorice la recurrencia. Una vez pagada, se crea la suscripción y un subscription_id se devuelve.

Puedes definir la frecuencia, la ventana de disponibilidad y el tipo de importe (fijo o variable) como parte del pago de la suscripción.

Campos para suscripciones	Descripción
Frecuencia	Define la frecuencia con la que se producirá el cobro de la suscripción, ya sea diaria, semanal o mensual, especificando el importe que debe cobrarse en el siguiente ciclo de facturación.
Disponibilidad	Las fechas de inicio y fin de la suscripción.
Importe	Define el valor que utilizarás para futuros pagos de la suscripción. Puede ser `FIXED` con un valor mínimo definido, o `VARIABLE` sin una cantidad definida para pagos futuros.

Como se ha mencionado antes, ten en cuenta que la información definida en la creación de la suscripción restringirá las fechas y valores que se utilizarán para futuros pagos.

{
  "amount": {
    "value": "100",
    "currency": "BRL"
  },
	"payment_method": {
        "type": "PIX_AUTOMATIC"
	},
	"subscription": {
    "frequency": {
      "type": "MONTH",
      "value": 1
    },
    "availability": {
      "start_at": "2025-05-23T20:17:30.277678Z",
      "finish_at": "2027-05-23T20:17:30.277678Z"
    },
    "amount": {
      "value": "100",
      "currency": "BRL",
      "type": "FIXED" // or "VARIABLE"
    }
  }

Una vez confirmado el pago inicial, el cliente tiene una suscripción activa, y puedes empezar a programar futuros cobros.

Paso 2: Pagos futuros

Según lo definido por el banco central, los pagos deben crearse como máximo 2 días antes de la fecha de facturación prevista y como mínimo 10 días después de la creación de la suscripción. Utiliza el subscription_id para identificar la recurrencia en la creaciónpago .

Campos para pagos futuros
`subscription_id`	ID de la suscripción obtenida en el primer paso.
fecha_facturación	Al especificar el objeto fecha_facturación, el comerciante puede definir la lógica que subyace a la fecha exacta de facturación de la suscripción.

"workflow": "DIRECT",
"amount": {
  "value": "100",
  "currency": "BRL"
},
"payment_method": {
  "type": "PIX_AUTOMATIC",
},
"subscription": {
  "id": "cab9f0fe-2428-419b-8f9d-4b5efee8c1c8",
  "billing_date": {
    "type": "DAY",
    "day": 14
  }
}

Si un pago recurrente falla, se puede reintentar utilizando un nuevo pago pedido. Los reintentos deben producirse en los 7 días siguientes a la fecha de facturación original y están limitados a 3 intentos por ciclo.