Reembolsos
Los reembolsos revierten un pago completado. Whop los procesa a través del procesador de pagos original. El estado de la membresía correspondiente se actualiza automáticamente.Emitir un reembolso
Crea los reembolsos sobre un pago, no directamente en el recurso de reembolsos. Llama apayments.refund({ id }). Omite partial_amount para un reembolso total o pásalo para uno parcial.
Payment actualizado. El campo refunded_amount refleja el total reembolsado acumulado. Puedes llamar a refund varias veces para un mismo pago hasta su importe total.
Permiso requerido:
payment:manage. Añádelo desde la guía de permisos antes de publicar tu app.Consultar reembolsos
Los reembolsos tienen su propio recurso por si necesitas consultarlos más tarde.Disputas
Una disputa (contracargo) se abre cuando el banco del comprador impugna un pago. Tienes un plazo para responder con pruebas antes de que el banco decida. Whop te reenvía la disputa, tú envías las pruebas, el banco dictamina y la disputa se cierra.Vigilar las disputas entrantes
Hay tres eventos a los que suscribirse:Listar y obtener
Responder con pruebas
Las disputas tienen una respuesta en dos pasos: prepara tus pruebas condisputes.update y luego envíalas con disputes.submit. La actualización es idempotente. Puedes editar los campos hasta que las envíes.
Campos de pruebas
Todos los campos son opcionales, pero cuanto más aportes, más sólida será la respuesta. Los más habituales:
Los campos de adjuntos aceptan un archivo subido como
{ id: file.id }. Súbelo primero mediante la API de archivos.
Estados de disputa
La disputa avanza a través de una máquina de estados. Hay dos fases: la fase de alerta temprana (estados con el prefijowarning_, que se notifican mediante dispute_alert.created) y la fase de disputa formal. Todos los estados que puede devolver el SDK:
Cuando una disputa se pierde, Whop no crea automáticamente un registro de reembolso y tampoco puedes crearlo tú.
payments.refund rechaza las llamadas sobre un pago disputado con This payment has been disputed. Therefore, it cannot be refunded. Toma la disputa perdida como fuente de verdad y no esperes un evento refund.created.Permisos
Añádelos desde la guía de permisos.
Próximos pasos
Aceptar pagos
El flujo que crea los pagos que más adelante reembolsarás o defenderás.
Escuchar webhooks
Reacciona a los eventos de reembolsos y disputas en el servidor.
Subir archivos
Sube adjuntos de pruebas para las respuestas a disputas.
Referencia de la API de disputas
El recurso completo: campos, estados y todos los endpoints.

