Reclamos
Responde y resuelve los reclamos de tus clientes desde tu servidor.
Usa billete.claims desde tu servidor. Configura el cliente con el entorno y la clave de tu negocio.
Ejemplo
const { data } = await billete.claims.list({ status: "open" });
for (const claim of data) {
await billete.claims.respond(claim.id, { message: "Lo estamos revisando." });
}
await billete.claims.resolve(
"clm_ejemplo",
{ outcome: "customer", note: "Te devolvemos el pago.", refund: {} },
{ idempotencyKey: "claim-clm_ejemplo-resolve" },
);Métodos
| Método | Qué hace |
|---|---|
retrieve(id, options?) | Consultar un reclamo. |
list(query?, options?) | Filtrar por status, payment, customer, search y sort. |
iterate(query?) | Recorrer reclamos. |
respond(id, input, options?) | Responder a tu cliente; la primera respuesta lo pasa a under_review. |
resolve(id, input, options?) | Resolverlo a favor de tu cliente (con refund, opcional) o de tu negocio. |
En el navegador
Tu cliente abre y sigue sus reclamos desde las páginas alojadas de Billete. Si construyes tus propias páginas, el cliente del navegador tiene checkouts.openClaim, invoices.openClaim, fulfillments.openClaim, customer.openClaim y claims (retrieve, respond, withdraw), que usan el enlace del reclamo como credencial.
Qué debes tener en cuenta
Abrir un reclamo no mueve dinero. Resolverlo con refund reembolsa el pago en el mismo paso: si el reembolso no procede, el reclamo sigue abierto. Un reclamo cerrado no se reabre.
Billete también media en los reclamos sobre una entrega con problema: puede escribir en la conversación (author: "billete") y decidirlo (resolution.by: "billete"). Resolverlo a favor de tu negocio no cierra la entrega, y si Billete le da la razón a tu cliente, le debes el pago (reglas).