RevGlanceDocumentación

Recurly

Conecta Recurly con una clave de API privada, en la región de EE. UU. o de la UE.

RevGlance lee la versión 2021-02-25 de la API de Recurly: facturas de cobros pagadas, transacciones de reembolso y suscripciones.

Conectar

  1. En Recurly, abre Integrations › API Credentials y añade una clave de API privada. Llámala RevGlance.
  2. Copia la clave y apunta el subdominio de tu sitio: acme para acme.recurly.com.
  3. Rellena la clave, la región donde está alojado tu sitio (us o eu) y el subdominio, y elige Conectar Recurly.

Qué pide el formulario

CampoAspecto
Clave de API privadaSe guarda cifrado0123456789abcdef0123456789abcdef
Regiónus o eu
Subdominio del sitioacme (de acme.recurly.com)

Introduce us o eu como región. Los sitios alojados en la UE usan la API de la UE de Recurly.

Añadir el webhook

  1. En RevGlance, abre Configuración › Fuentes, abre el menú de la fuente de Recurly y elige Webhook. Copia la URL.
  2. En Recurly, abre Integrations › Webhooks y añade un endpoint con esa URL en formato JSON.
  3. Copia el secreto de firma del endpoint, pégalo en Secreto de firma en RevGlance y guarda.

RevGlance comprueba la cabecera recurly-signature y rechaza las llamadas de hace más de cinco minutos.

Qué sincroniza RevGlance

  • Facturas de cobros pagadas, antes de impuestos.
  • Transacciones de reembolso correctas, descontando los impuestos en la misma proporción que en la factura.
  • Suscripciones, para el MRR, los planes, las pruebas y las cancelaciones. Recurly no da ningún motivo de cancelación a través de su API ni informa de comisiones de la pasarela.

Cómo se cuenta Recurly

  • Las facturas de cobro pagadas cuentan antes de impuestos.
  • Los reembolsos son las transacciones de reembolso correctas. Incluyen impuestos, así que RevGlance resta el impuesto en la misma proporción que en la factura.
  • Recurly no informa las comisiones de la pasarela, así que las comisiones aparecen como cero.
  • El MRR es el subtotal de Recurly para la suscripción (importe unitario, cantidad y complementos, después de cupones y antes de impuestos).
  • Una suscripción cancelada sigue contando hasta que vence; las vencidas, fallidas y en pausa cuentan como baja. Recurly no da el motivo de cancelación a través de la API.
  • Un pago que no se pudo cobrar cuenta como cobro fallido. No mueve dinero.
  • Los contracargos no se leen, así que uno perdido sigue contando como cobro salvo que el proveedor también lo informe como reembolso.

Correos de recuperación

Recuperar lleva al cliente a la página de su cuenta alojada en tu sitio de Recurly, por eso el formulario pide el subdominio.