Skip to main content
Permite que tus subcuentas completen la verificación Know Your Customer (KYC), añadan métodos de pago saliente y retiren sus fondos por su cuenta. Puedes montar las superficies de wallet de Whop Elements directamente en tu app o redirigir a los usuarios a un portal alojado por Whop.

Portal de pagos salientes incrustado

Implementación en el servidor

Para montar los wallet elements, genera un token de acceso para la subcuenta en tu servidor. Los elements leen con él el saldo y los pagos salientes de esa cuenta. Consulta Autenticación y claves de API para saber cómo limitar el alcance de ese token y cómo se compara con los demás tipos de credenciales de Whop.

API Create Access Token

Consulta la referencia completa de la API para generar tokens de acceso y todos los parámetros disponibles

Configuración en el cliente

Implementación en el cliente

Crea un handle de Wallet para la subcuenta y monta debajo las superficies que necesites. El handle envía su token de acceso a todos los elements que contiene, así que genera un único token que incluya todos los scopes que leen esos elements.
En iOS, el SDK de wallet incluye BalanceElement, ListElement y ActivityElement. Consulta Primeros pasos con Elements y elige la pestaña Swift.

Verificación de identidad

Una subcuenta debe verificar su identidad antes de poder retirar fondos. Monta el element de KYC para el flujo completo dentro de la página, que recopila los datos, ejecuta la sesión alojada del proveedor e informa del resultado. O monta el element RequiredActions para mostrar todas las acciones pendientes, incluida la verificación, y permitir que el usuario inicie cada una.
React

Opciones de Wallet

Todas las opciones, eventos y métodos se enumeran en la referencia de Wallet.

Scopes

Los elements leen con el token que generas, así que concede en ese único token todos los scopes que necesitan:
  • Balances y Activity leen company:balance:read.
  • Withdraw necesita payout:withdraw_funds, payout:destination:read y payout:create_destination para añadir un banco.
  • KYC necesita identity:read e identity:write.
Un token creado sin scoped_actions hereda todos los permisos de tu clave de API.

Renovar el token

Los tokens de acceso caducan después de una hora de forma predeterminada y de tres horas como máximo. Establece uno nuevo en el handle antes de que caduque:
En React, pasa el nuevo valor como la prop accessToken.
accessToken es un valor que estableces, no un callback al que llama el SDK. Verifications es la excepción: acepta un callback getToken y lo llama antes de que se monte el element.

Portal de pagos salientes alojado

En lugar de incrustar el portal de pagos salientes en tu app, puedes redirigir a los usuarios a un portal de pagos salientes alojado por Whop. Es útil cuando no quieres crear una interfaz personalizada o necesitas una integración rápida. Crea un enlace de cuenta y redirige al usuario a la URL devuelta:
En este ejemplo:
  • account_id es la plataforma o la subcuenta
  • use_case especifica el tipo de portal
  • return_url es adonde Whop redirige al usuario cuando quiere volver a tu sitio
  • refresh_url es adonde Whop redirige al usuario si la sesión caduca

Casos de uso disponibles

Después de crear el enlace de cuenta, redirige al usuario a la url devuelta en la respuesta. El usuario completa el flujo de pago saliente en el portal alojado por Whop y luego Whop lo redirige a tu return_url.

Wallet elements

Todas las superficies de wallet con sus opciones, eventos y scopes

Pagar a subcuentas

Transfiere fondos a subcuentas