Entregas
Consulta el estado de una compra física y registra su entrega.
Usa billete.fulfillments desde tu servidor. Configura el cliente con el entorno y la clave de tu negocio.
Ejemplo
// El valor que escaneaste del QR que te muestra tu cliente
const {
data: [scanned],
} = await billete.fulfillments.list({ handoverCode: valorEscaneado });
await billete.fulfillments.handOver(scanned.id, { code: valorEscaneado });
const fulfillment = await billete.fulfillments.retrieve("ful_ejemplo");
await billete.fulfillments.submitTracking(
fulfillment.id,
{ number: "GUIA_EJEMPLO" },
{ idempotencyKey: "tracking-order-123" },
);Métodos
| Método | Qué hace |
|---|---|
retrieve(id, options?) | Consultar una entrega. |
list(query?, options?) | Filtrar por status, search, handoverCode y sort. |
iterate(query?) | Recorrer entregas. |
submitTracking(id, input, options?) | Enviar una guía para verificación. |
handOver(id, input, options?) | Entregar con el código que muestra el cliente (code). |
deliver(id, options?) | Marcar la entrega realizada sin el código. |
En el navegador
Tu cliente sigue su entrega en la página alojada de Billete. Si construyes la tuya, el cliente del navegador tiene fulfillments (retrieve, confirmReceived, openClaim, reportProblem y setRefundDestination, para indicar dónde recibir la devolución que le debe tu negocio), con el enlace de la entrega como credencial.
Qué debes tener en cuenta
Enviar una guía no confirma su aceptación. Al entregarla con el código del cliente, este dispone de 24 horas para confirmar o reportar un problema; al marcarla sin el código, de 48. El negocio no debe confirmar la recepción en nombre del cliente. Si reporta un problema, sigue abierta hasta que confirme que la recibió o Billete lo resuelva. Un envío sin guía válida antes de trackingDueAt se cancela y tu negocio le debe el pago al cliente.