UNIpagos Platform API · v1
Documentación técnica
Rieles, cobros y marca blanca sobre las mismas claves de Infrastructure.
UNIpagos no es un PSP ni un adquirente por sí mismo.
Base https://unipagos.com.ar/api/platform/v1.
Inicio rápido
Tres llamadas para un QR cobrado
# 1. Resolvé la cuenta que cobra
POST https://unipagos.com.ar/api/platform/v1/directory/lookup
Authorization: Bearer sk_baas_test_…
{"query": "tienda.centro.unipagos"}
# 2. Generá el QR dinámico
POST https://unipagos.com.ar/api/platform/v1/qrs
Idempotency-Key: qr_001
{"account": "acc_…", "kind": "dynamic", "amount": 1500}
# 3. El pagador confirma (sandbox)
POST https://unipagos.com.ar/api/platform/v1/qrs/{id}/pay
{"payer": "acc_pagador_…"}
En sandbox el débito a la vista se acepta con POST /pulls/{id}/accept
y el desafío de compra se valida con el código 123456.
Autenticación
Las mismas claves de Infrastructure
- Header
Authorization: Bearer sk_baas_test_…osk_baas_live_… -
Idempotency-Keyen cada POST para no duplicar cobros ni débitos - Los webhooks se firman con el mismo secret HMAC-SHA256 de Infrastructure
- Producción exige el programa en estado activo; sandbox funciona desde el alta
Recursos
Mapa de la API
Catálogo
| Método | Ruta | Qué hace | |
|---|---|---|---|
GET |
/health |
Estado del servicio | público |
GET |
/products |
Catálogo de productos Platform | público |
GET |
/rails |
Rieles por país | público |
GET |
/events |
Eventos de webhook | público |
GET |
/docs |
Este índice | público |
GET |
/me |
Programa y métricas Platform | con clave |
GET |
/stats |
Métricas Platform | con clave |
Rieles y cobros
| Método | Ruta | Qué hace | |
|---|---|---|---|
POST |
/directory/lookup |
Resolver alias o número de cuenta | con clave |
POST |
/beneficiaries |
Guardar beneficiario | con clave |
POST |
/pulls |
Crear débito a la vista | con clave |
POST |
/pulls/{id}/accept |
Aceptar débito (sandbox) | con clave |
POST |
/pulls/{id}/reject |
Rechazar débito | con clave |
POST |
/echeqs |
Emitir cheque digital | con clave |
POST |
/echeqs/{id}/status |
Aceptar, depositar o anular | con clave |
POST |
/boxes |
Crear caja de recaudación | con clave |
QR y aceptación
| Método | Ruta | Qué hace | |
|---|---|---|---|
POST |
/qrs |
Generar QR | con clave |
POST |
/qrs/{id}/pay |
Pagar un QR | con clave |
POST |
/merchants |
Alta de comercio | con clave |
POST |
/merchants/{id}/charges |
Cobrar con split | con clave |
POST |
/charges/{id}/refund |
Reembolsar cargo | con clave |
Tarjetas extra
| Método | Ruta | Qué hace | |
|---|---|---|---|
POST |
/3ds |
Crear desafío de autenticación | con clave |
POST |
/3ds/{id}/authenticate |
Validar código | con clave |
POST |
/wallets |
Aprovisionar tarjeta en billetera | con clave |
GET |
/cards/{id}/sensitive |
Ver PAN de prueba (solo sandbox) | con clave |
POST |
/disputes |
Abrir contracargo | con clave |
POST |
/disputes/{id}/status |
Resolver contracargo | con clave |
POST |
/controls |
Aviso de viaje o bloqueo | con clave |
POST |
/controls/{id}/lift |
Levantar control | con clave |
POST |
/on-us |
Transferencia entre tarjetas del programa | con clave |
Marca y envíos
| Método | Ruta | Qué hace | |
|---|---|---|---|
POST |
/branding |
Configurar marca blanca | con clave |
GET |
/branding |
Ver marca blanca | con clave |
POST |
/corridors |
Envío EE.UU. → LATAM | con clave |
POST |
/installment-plans |
Crear plan de cuotas | con clave |
POST |
/installment-plans/{id}/quote |
Cotizar cuotas | con clave |
POST |
/kyb |
Verificar empresa | con clave |
POST |
/virtual-accounts |
Cuenta virtual de conciliación | con clave |
POST |
/virtual-accounts/{id}/credit |
Acreditar en la cuenta virtual | con clave |
POST |
/messages |
Enviar aviso por canal | con clave |
POST |
/loyalty |
Acreditar o canjear puntos | con clave |
Eventos
Avisos que llegan a tu webhook
| Evento | Cuándo |
|---|---|
directory.resolved | Se resolvió un destino de pago |
beneficiary.created | Se guardó un beneficiario |
pull.created | Se creó un débito a la vista |
pull.paid | El pagador aceptó y se acreditó |
pull.rejected | El pagador rechazó el débito |
echeq.issued | Se emitió un cheque digital |
echeq.deposited | El cheque se depositó |
qr.created | Se generó un QR |
qr.paid | Un QR fue pagado |
merchant.created | Se dio de alta un comercio |
charge.paid | Cargo de aceptación cobrado |
charge.refunded | Cargo reembolsado |
secure.created | Desafío de autenticación creado |
secure.authenticated | Desafío autenticado |
wallet.provisioned | Tarjeta aprovisionada en billetera |
dispute.opened | Contracargo abierto |
dispute.resolved | Contracargo resuelto |
control.applied | Control de tarjeta aplicado |
loyalty.moved | Movimiento de puntos |
branding.updated | Marca blanca actualizada |
corridor.created | Orden del corredor creada |
corridor.delivered | Orden del corredor entregada |
kyb.updated | Cambió la verificación de empresa |
va.created | Cuenta virtual de conciliación creada |
va.credited | Cobro acreditado en cuenta virtual |
message.sent | Aviso de canal registrado |
Los eventos de Platform usan el mismo destino que configuraste en Infrastructure.
Filtrá por nombre de evento o suscribite a *.