Skip to main content
Hay dos formas de cobrar pagos para subcuentas:
  1. Cargos directos: crea un checkout para la subcuenta y cobra una comisión de aplicación.
  2. Transferencias: cobra el pago en la cuenta de tu plataforma y transfiere fondos a las subcuentas más tarde.

Cargos directos

Crea una configuración de checkout con el ID de una subcuenta para cobrar a los clientes directamente en la subcuenta. La subcuenta es responsable de las comisiones de Whop, los reembolsos y las disputas.

Cómo funciona

  1. Crea una configuración de checkout para tu subcuenta con un application_fee_amount
  2. Cuando un cliente compra, Whop crea el cargo directamente en la subcuenta
  3. Tu plataforma cobra la comisión de aplicación y el importe restante va a la subcuenta
  4. La subcuenta gestiona las disputas o reembolsos de la transacción

Ejemplo

Crea una variante en línea usando la entrada de compatibilidad llamada plan.
En este ejemplo:
  • account_id es el ID de la subcuenta donde Whop creará el cargo
  • variant.initial_price es el importe total del pago de la variante (10,00 dólares estadounidenses)
  • variant.application_fee_amount es la comisión que cobra tu plataforma (1,23 dólares estadounidenses)
  • La subcuenta recibe 8,77 dólares estadounidenses (10,00 - 1,23)

Limitaciones

  • El application_fee_amount debe ser positivo e inferior al importe total del pago
  • La comisión de aplicación no puede superar el importe capturado del pago

Transferencias

Usa transferencias cuando tu plataforma cobra primero el pago o cuando tu backend decide cuánto y cuándo pagar a cada subcuenta.

Antes de transferir

  • Cuenta de origen: la cuenta que envía los fondos debe completar la verificación Know Your Customer (KYC) y tener saldo suficiente para la transferencia. Puedes recargar el saldo desde el panel o mediante Añadir fondos a tu saldo.
  • Cuenta de destino: el destinatario ya debe tener una cuenta de Whop. Si no la tiene, incorpóralo primero con Dar de alta subcuentas.
  • Titularidad de la liquidación: con las transferencias, tu plataforma es el comerciante registrado (merchant of record) del pago original. Tu plataforma gestiona las comisiones, disputas y reembolsos de ese pago.

Ejemplo

Cobra el pago en la cuenta de tu plataforma y luego transfiere la parte de la subcuenta:
En este ejemplo:
  • origin_id es el ID de la cuenta de tu plataforma (de donde Whop descuenta los fondos)
  • destination_id es el ID de la subcuenta (donde Whop abona los fondos)
  • amount es el importe que se transferirá
  • metadata almacena datos personalizados para tu referencia

Gestionar los fallos de transferencia

Las transferencias fallan si la cuenta de origen no está verificada, si el saldo de origen es insuficiente o si la cuenta de destino aún no puede recibir fondos. Corrige la causa subyacente antes de reintentar. No reintentes transferencias fallidas sin revisar la causa.

Usos habituales

  • Pagos salientes programados a creadores
  • Pagos salientes a afiliados
  • Repartos de marketplace después de que se liquide un pedido

Elegir un flujo de pago

Usa transferencias cuando tu backend controla el momento y el importe de los pagos salientes. Usa cargos directos cuando la subcuenta deba asumir las comisiones, disputas y reembolsos de la compra original.

Referencia de la API

Create Checkout Configuration

Crea configuraciones de checkout con comisiones de aplicación

Create Transfer

Transfiere fondos entre cuentas

Aceptar pagos

Descubre los enlaces de checkout y el Checkout element

Dar de alta subcuentas

Crea cuentas de destinatarios y completa la incorporación antes de pagarles