Saltar al contenido principal
POST
Crear notificación previa al débito
Antes de cada débito recurrente de UPI Autopay, NPCI exige notificar al cliente con anticipación. Este endpoint envía ese aviso a través del proveedor de pagos y devuelve un id que debes referenciar en el débito. El flujo tiene tres pasos:
  1. Notificar: llama a este endpoint con el vaulted_token del mandato, el amount próximo y la billing_date. El enrutamiento al proveedor proviene de origin_payment_id (el pago que creó el mandato) o de un provider_data explícito.
  2. Revisar el estado: SENT significa que el proveedor entregó la notificación y devolvió su referencia en provider_data.provider_notification_id.
  3. Debitar: crea el pago recurrente con payment_method.detail.bank_transfer.pre_debit_notification_id establecido con el id devuelto. Yuno resuelve la referencia del proveedor y la reenvía automáticamente (consulta Crear pago).
Esta solicitud requiere un X-Idempotency-Key. Si reutilizas un merchant_reference, se devuelve la notificación existente de tu cuenta.

Autorizaciones

public-api-key
string
header
predeterminado:<Your public-api-key>
requerido
private-secret-key
string
header
predeterminado:<Your private-secret-key>
requerido

Encabezados

X-Idempotency-Key
string
requerido

Identificador único que se usa en los encabezados HTTP para garantizar que una solicitud se procese una sola vez, aunque se reintente por problemas de red o timeouts.

Cuerpo

application/json
account_id
string<uuid>
requerido

El ID de tu cuenta de Yuno.

merchant_reference
string
requerido

Tu referencia única para esta notificación. Reutilizar una referencia devuelve la notificación existente (idempotente por cuenta).

amount
object
requerido
billing_date
string<date>
requerido

Fecha del próximo débito (YYYY-MM-DD). Según NPCI, notifica al cliente al menos 24 horas antes del débito.

description
string

Texto que se muestra al cliente en la notificación (por ejemplo, el nombre de la suscripción y el aviso de renovación).

billing_sequence_number
string

Número de secuencia del débito dentro del mandato (por ejemplo, 2 para el segundo cargo).

origin_payment_id
string<uuid>

ID del pago de creación del mandato. Si se proporciona, Yuno deriva el proveedor y la conexión a partir de su cargo exitoso. Se requiere origin_payment_id o provider_data.

customer_payer
object
payment_method
object
provider_data
object

Enrutamiento explícito al proveedor. Se requiere origin_payment_id o provider_data (id + connection_id).

Respuesta

Notificación creada. Revisa el estado: SENT significa que el proveedor la entregó.

id
string<uuid>

Identificador único de la notificación previa al débito. Haz referencia a él en el débito recurrente como payment_method.detail.bank_transfer.pre_debit_notification_id.

account_id
string<uuid>

El ID de tu cuenta de Yuno.

status
enum<string>

SENT: el proveedor aceptó y entregó la notificación. REJECTED: el proveedor la rechazó. ERROR: no se pudo transmitir la notificación.

Opciones disponibles:
SENT,
REJECTED,
ERROR
merchant_reference
string

Tu referencia única para esta notificación (idempotente por cuenta).

description
string

Texto que se muestra al cliente en la notificación.

amount
object
billing_date
string<date>

Fecha del próximo débito (YYYY-MM-DD).

origin_payment_id
string<uuid>

El pago de creación del mandato que se usó para derivar el proveedor y la conexión, cuando se proporciona.

provider_data
object
created_at
string<date-time>
updated_at
string<date-time>