Saltar al contenido principal

Créditos y facturación

Una llave live gasta créditos. Una llave de prueba nunca.

LlamadaCréditos
Una estimación de texto10
Una estimación con foto25
Un seguimiento5

Una llamada aparta sus créditos antes de que corra el estimador y los cobra cuando responde. Una llamada que falla los devuelve. GET /v1/balance devuelve lo que queda, lote por lote.

Lotes y caducidad​

Los créditos llegan en lotes, y cada lote tiene su propia caducidad:

  • Un paquete dura 12 meses desde la compra.
  • Los créditos del plan Business duran hasta que termina el periodo con el que llegaron.
  • Los créditos de Free live duran hasta que termina el mes.

Primero se gasta el lote que caduca antes. Cuando el saldo no alcanza para una llamada, responde 402 insufficient_credits y no cobra nada.

Comprar créditos​

Compra paquetes y planes en el panel, en Facturación, o manda al cliente a una página de Checkout desde tu propio código:

curl https://api.wfskills.com/v1/billing/checkout \
  -H "Authorization: Bearer $HOMETOWN_LIVE_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"pack": "credits_10000", "success_url": "https://example.com/billing/done", "cancel_url": "https://example.com/billing"}'

La respuesta trae la página en url. Los créditos llegan cuando la factura queda pagada, unos segundos después del pago, nunca al volver a success_url. Esta ruta necesita una llave live con el permiso billing:manage; una llave de prueba responde 403 test_key_on_live_route.

pack acepta credits_2500, credits_10000, credits_50000, plan_api_business o addon_records. Las facturas necesitan la razón social, la dirección y el país para el impuesto. Sin ellos la ruta responde 422 billing_profile_incomplete. Llénalos una vez en el panel.

Las facturas y la tarjeta guardada están en el panel, en Facturación, en páginas de Stripe.

Tope mensual​

Fija en el panel un tope mensual en créditos. Una llamada que lo pasaría responde 402 monthly_cap_reached y no cobra nada. La respuesta trae resets_at, el primer día del mes siguiente en la zona horaria de la cuenta.

Recarga automática​

Elige en el panel un paquete y un umbral. Cuando una llamada live deja el saldo bajo el umbral, Hometown compra ese paquete con la tarjeta guardada. Corre una recarga a la vez, así que una ráfaga de llamadas se cobra una sola vez. Los créditos llegan con la factura pagada, como en cualquier compra.

Free live​

Una cuenta abierta en el panel recibe 1,000 créditos live cada mes en cuanto tiene el correo verificado, un teléfono y una tarjeta guardada. Esas mismas tres cosas abren la primera llave live. Los créditos duran hasta que termina el mes.

Cuando falla un pago​

Un pago rechazado marca la cuenta como vencida, y la API sigue funcionando. La tercera falla en 14 días la suspende: toda llamada responde 403 tenant_suspended. Pagar la factura abierta en el panel vuelve a abrir la cuenta.

Última actualización en