Documentación técnica

Niveles

Enviar controles

curl -X POST https://unipagos.com.ar/api/baas/v1/users/user-4821/kyc \
  -H "Authorization: Bearer sk_baas_test_…" \
  -H "Content-Type: application/json" \
  -d '{
    "checks": [
      {"type": "document", "result": "passed", "score": 95},
      {"type": "liveness", "result": "passed", "score": 92},
      {"type": "tax", "result": "passed"},
      {"type": "sanctions", "result": "passed"}
    ]
  }'

Tipos aceptados: document, liveness, address, tax, company, pep y sanctions. Al completar los controles del nivel, emitimos user.kyc.updated.

Tipos de cuenta

Monedas disponibles: USD y las locales de cada país (ARS, BRL, MXN, COP, CLP, PEN, UYU, PYG).

Transferir

curl -X POST https://unipagos.com.ar/api/baas/v1/transfers \
  -H "Authorization: Bearer sk_baas_live_…" \
  -H "Idempotency-Key: pay-9931" \
  -d '{
    "from": "2876263442317436075686",
    "to": "ana.pagos.uni",
    "amount": 1250.50,
    "description": "Pago de servicio"
  }'

Origen y destino aceptan número de cuenta, alias o la palabra float. La comisión de tu plan se descuenta y se registra por separado.

Emitir una tarjeta

curl -X POST https://unipagos.com.ar/api/baas/v1/cards \
  -H "Authorization: Bearer sk_baas_live_…" \
  -H "Idempotency-Key: card-4821" \
  -d '{
    "program": "UPBDC220",
    "end_user": "user-4821",
    "account": "2876263442317436075686",
    "form": "virtual",
    "daily_limit": 800,
    "online_enabled": true,
    "international_enabled": false
  }'

La tarjeta física se pide con form: physical y su envío se sigue con POST /cards/{id}/shipment.

Motivos de rechazo

Cuando una autorización se rechaza, devolvemos el motivo en decline_reason y emitimos card.authorization.declined.

Cotizar y convertir

curl -X POST https://unipagos.com.ar/api/baas/v1/fx/quotes \
  -H "Authorization: Bearer sk_baas_live_…" \
  -d '{"from": "USD", "to": "ARS", "amount": 100}'

{
  "data": {
    "id": "qt_…",
    "from": "USD",
    "to": "ARS",
    "amount": 100,
    "market_rate": 1200.00,
    "rate": 1190.40,
    "result": 119040.00,
    "expires_at": "2026-08-14 01:25:00"
  }
}

La cotización queda bloqueada hasta su vencimiento. Para ejecutarla, pasás su id a POST /fx/convert junto con las dos cuentas.

Envíos entre países

curl -X POST https://unipagos.com.ar/api/baas/v1/cross-border \
  -H "Authorization: Bearer sk_baas_live_…" \
  -H "Idempotency-Key: xb-8891" \
  -d '{
    "from_account": "2876263442317436075686",
    "to_country": "MX",
    "amount": 300,
    "beneficiary_name": "Luis Ramírez",
    "beneficiary_document": "RAML870512",
    "payout": "cash"
  }'

La orden devuelve código de retiro y estado. Al entregarse emitimos crossborder.delivered.

Verificar la firma

Firmamos el cuerpo con HMAC-SHA256 usando el secret del destino y lo enviamos en X-Unipagos-Signature. Respondé 2xx para confirmar la recepción.

<?php
$payload = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_UNIPAGOS_SIGNATURE'] ?? '';
$secret = getenv('UNIPAGOS_BAAS_WEBHOOK_SECRET'); // whsec_...

if (!hash_equals(hash_hmac('sha256', $payload, $secret), $signature)) {
    http_response_code(401);
    exit('invalid signature');
}

$event = json_decode($payload, true);
switch ($event['event']) {
    case 'card.authorization.approved':
        // notificar al usuario final en tu app
        break;
    case 'transfer.completed':
        // marcar la orden como acreditada
        break;
}

http_response_code(200);
echo 'ok';

Eventos