Skip to main content
Whop fournit un environnement sandbox pour tester votre intégration sans affecter les données de production ni effectuer de paiements réels.

URL du sandbox

Créez votre compte sandbox et vos clés API sur sandbox.whop.com.

Configuration du kit de développement logiciel

Pour utiliser l’environnement sandbox avec le SDK Whop, transmettez l’environnement Sandbox. Un environnement désigne chaque hôte avec lequel le SDK communique, de sorte que toutes les requêtes basculent vers le sandbox en une seule fois.
L’environnement Sandbox est arrivé avec le SDK 2.0. En 1.x, pointez plutôt le client vers https://sandbox-api.whop.com/api/v1 : baseUrl en TypeScript, base_url en Python et Ruby, option.WithBaseURL en Go. TypeScript, Ruby et Go conservent cette surcharge en 2.0, mais elle envoie toutes les requêtes vers un seul hôte. Les opérations qui doivent atteindre un autre hôte sont alors refusées : utilisez donc environment. Le client Python 2.0 n’a pas de paramètre base_url. Le SDK Rust est toujours en 1.x et conserve base_url.

Elements dans le sandbox

Pour pointer Whop Elements vers le sandbox, définissez environment lors de la création de l’instance du SDK. Cette option est le seul moyen de changer la destination de ce qu’un acheteur saisit dans les éléments. La propriété Elements permettant de sélectionner une variante reste nommée plan pour des raisons de compatibilité.

Clés d’interface de programmation et webhooks

Les clés API et les webhooks fonctionnent de la même façon dans le sandbox qu’en production :
  • Créez des clés API sur sandbox.whop.com/dashboard/developer
  • Configurez des webhooks pour recevoir les événements du sandbox
  • Utilisez les mêmes en-têtes d’authentification (Authorization: Bearer YOUR_API_KEY)

Cartes de test

Utilisez les numéros de carte de test suivants pour simuler des paiements dans le sandbox : En production, un paiement refusé comporte un code de l’émetteur de la carte. La page Codes de refus de paiement expliqués indique la signification de chacun. Pour toutes les cartes de test :
  • Utilisez n’importe quelle date d’expiration future (par exemple 12/34)
  • Utilisez n’importe quel cryptogramme visuel à 3 chiffres (par exemple 123)
  • Utilisez n’importe quelle adresse de facturation
Utilisez 4000 0000 0000 0341 pour tester les parcours de récupération dans lesquels vous enregistrez une carte avec succès, mais où un débit ultérieur sur cette carte enregistrée échoue.

Moyens de paiement dans le sandbox

Pour tester les paiements par carte, utilisez les cartes de test ci-dessus. Ces moyens de paiement aboutissent également dans le sandbox via le parcours de test propre à chaque fournisseur : PayPal, Bancontact, iDEAL, Cash App Pay, Pix et Boleto. Ces moyens de paiement ne sont pas encore pris en charge dans le sandbox :
  • Apple Pay et Google Pay
  • Comptes bancaires (ACH)
  • Prélèvement SEPA
  • Virements bancaires européens et virements télégraphiques
  • Alipay, WeChat Pay et MobilePay

Limites connues

Les fonctionnalités suivantes ne sont pas disponibles dans le sandbox :
  • Versements
  • Dépôts crypto et transferts on-chain
  • Messages directs Discord et synchronisation des rôles
  • Résultats de recherche à jour
  • Certaines tâches planifiées et en arrière-plan exécutées en production, comme les examens anti-fraude et les e-mails récapitulatifs