VoilaTier VoilaTier
ES EN
Empezar gratis
Developers

Una API que a tus ingenieros
sí les va a gustar.

REST y GraphQL con idempotency keys, rate limits escalonados, SDKs nativos en cinco lenguajes y webhooks que no se caen. SOC 2 Type II, deterministas y bien documentados.

Leer la documentación →
Acumula puntos · 4 líneas

Una API tipada, idempotente y bien diseñada. Envía una transacción, recibes de vuelta el nivel actualizado del cliente, el saldo de puntos y cualquier recompensa disparada — en un solo round trip.

P95 · 78ms · endpoint de earn 99.99% · uptime
node.js python ruby go curl
⌘ C 
// Acumular puntos en una transacción
const { customer, rewards } = await voilatier.earn({
  customer: "cust_01HXQ8R3M7TZ2PN9",
  amount: 52.40,
  currency: "USD",
  location: "loc_mission_bay",
  idempotency_key: "ord_4782",
});

console.log(customer.tier);    // "Insider"
console.log(customer.points);  // 2840
console.log(rewards);          // [{ id: "rwd_…", type: "free_pastry" }]
P95 · 78mslatencia endpoint earn
4.2Beventos / mes
5SDKs nativos
120+tipos de eventos webhook
Referencia

Endpoints principales.

Todos los endpoints están versionados, son idempotentes y tienen rate limits por workspace. JSON in, JSON out.

Explorar API en Swagger UI → Descargar OpenAPI JSON
POST/v3/customersCrear o upsertar un perfil de cliente.v3 · stable
GET/v3/customers/:idObtener el perfil completo, incluyendo nivel, puntos y predicciones.v3 · stable
POST/v3/transactionsRegistrar una transacción. Dispara reglas de earn y evaluación de nivel.v3 · stable
POST/v3/rewards/:id/redeemCanjear una recompensa. Devuelve prueba de canje y copy del recibo.v3 · stable
GET/v3/segments/:id/membersStreamear membresía del segmento · paginación por cursor.v3 · stable
POST/v3/journeys/:id/enrollInscribir un cliente en un customer journey en un nodo específico.v3 · stable
POST/v3/passesEmitir un pase de Apple/Google Wallet para un cliente.v3 · stable
PUT/v3/tiers/rulesActualizar reglas de calificación de nivel (versionadas, auditadas).v3 · stable
POST/v3/ai/campaigns/draftPedirle a VoilaTier AI que arme un borrador de campaña desde un brief.v3 · beta
GET/v3/events:streamStream de eventos en tiempo real (Server-Sent Events).v3 · stable
SDKs

Cinco lenguajes.
Un mismo modelo mental.

Generados desde nuestro spec OpenAPI, refinados a mano, semver estable. Tipados donde importa.

JSJavaScript / TS
npm i @voilatier/node
v3.4.1 · MIT
PyPython
pip install voilatier
v3.4.0 · MIT
RbRuby
gem install voilatier
v3.3.2 · MIT
GoGo
go get voilatier.com/go
v3.4.1 · Apache 2
SwSwift
.package "voilatier-swift"
v2.8.0 · MIT
KtKotlin
com.voilatier:android
v2.8.0 · MIT
cliVoilaTier CLI
brew install voilatier
v1.4.0 · MIT
GqGraphQL
/v3/graphql endpoint
v3 · stable
Webhooks

Eventos que no se caen.

120+ tipos de eventos sobre clientes, transacciones, niveles, recompensas, customer journeys y predicciones de IA. Payloads firmados, reintentos automáticos con backoff exponencial y ventana de replay de 7 días desde el panel.

  • Firmados por HMAC, con timestamp window
  • Reintentos exponenciales · hasta 7 días
  • Reglas de filtro y múltiples endpoints por workspace
customer.tier.upgraded
payload 
{
  "id": "evt_01HZK4M…N9",
  "type": "customer.tier.upgraded",
  "created": "2026-04-12T18:42:11Z",
  "data": {
    "customer_id": "cust_01HXQ8R3…",
    "from_tier": "premier",
    "to_tier": "insider",
    "reason": "qualifying_spend",
    "effective_at": "2026-04-12T18:42:11Z"
  },
  "signature": "v1=8a3f…c721"
}

Lee la documentación.

Referencia API, guías, recetas y un workspace público de Postman.

Abrir docs → Status page