Skip to main content
Después de que un pago se procesa pueden ocurrir dos cosas. Los reembolsos son una reversión que tú (o tu equipo de soporte) emites de forma intencionada. Las disputas son contracargos que el comprador presenta ante su banco. No siempre controlas cómo se resuelve una disputa, pero puedes responder con pruebas.
Suscríbete a los webhooks de refund.created, refund.updated, dispute.created, dispute.updated y dispute_alert.created para poder conciliar los cambios de estado sin hacer sondeos.

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 a payments.refund({ id }). Omite partial_amount para un reembolso total o pásalo para uno parcial.
La respuesta es el objeto 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 con disputes.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 prefijo warning_, 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.