API de Vueltos y Pagos Automáticos

Automatiza la entrega de vueltos por pago móvil y pagos de nómina usando nuestro endpoint dedicado.

Dar Vuelto / Enviar Pago

Este endpoint procesa un pago móvil inmediato hacia el banco de destino proporcionado. Se utiliza típicamente para devolver el cambio en efectivo de manera digital o para la automatización de nóminas y pagos de comisiones a terceros.

POST

/v1/user-bank-accounts/{account_id}/transaction-change

Parámetros de la URL

Parámetro	Tipo	Descripción
account_id	`string`	ID de tu cuenta bancaria configurada en Pabilo (Debe soportar C2P).

Cuerpo de la Petición (JSON)

Campo	Tipo	Requerido	Descripción
dni.code	`string`	Sí	Letra de la cédula del destinatario (V, E, J, P, G).
dni.number	`string`	Sí	Número de cédula o RIF del destinatario.
phone_pagador	`string`	Sí	Teléfono celular asociado a la cuenta de destino (formato: 04141234567).
amount	`number`	Sí	Monto en Bolívares (Bs) a transferir. Mayor a 0.
invoice_number	`string`	Sí	Número de factura o referencia de tu sistema interno. Debe contener exclusivamente un valor numérico en formato string (ej. "10029").
destination_bank_code	`string`	Sí	Código numérico oficial del banco receptor (ej. "0102", "0108").

Ejemplo de Petición

curl -X POST https://api.pabilo.app/v1/user-bank-accounts/{account_id}/transaction-change \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "dni": {
      "code": "V",
      "number": "12345678"
    },
    "phone_pagador": "04141234567",
    "amount": 150.50,
    "invoice_number": "10029",
    "destination_bank_code": "0102"
  }'

Respuesta Exitosa

En caso de éxito, recibirás la confirmación del banco emisor incluyendo el número de referencia.

{
  "message": "Transaction change created successfully",
  "data": {
    "transaction_changes": {
      "reference": "123456789012",
      "authorization_code": "AUTH987",
      "status": "APPROVED"
    }
  }
}

Gestión de Facturas Atómicas

Es importante mencionar que si tu sistema no maneja su propia secuencia de facturas, puedes utilizar nuestro endpoint de generación antes de enviar el vuelto:

GET

/v1/user-bank-accounts/{account_id}/payment-links/next-invoice-number

Este endpoint devuelve el correlativo siguiente seguro y de forma atómica.