paypal-integration

Vue d'ensemble

La compétence paypal-integration permet un traitement fluide des paiements PayPal pour votre site e-commerce ou application web. Elle prend en charge le paiement express, les abonnements récurrents, la gestion des remboursements ainsi que les webhooks PayPal (IPN) pour des mises à jour de paiement en temps réel. Cette compétence est conçue pour les développeurs et équipes souhaitant ajouter rapidement PayPal comme option de paiement, automatiser les cycles de facturation ou gérer efficacement les remboursements et litiges.

Fonctionnalités clés

• Ajoutez PayPal comme méthode de paiement avec une configuration minimale
• Support des paiements ponctuels et du paiement express
• Activation de la facturation récurrente et gestion des abonnements
• Gestion des remboursements, litiges et notifications de paiement (IPN)
• Compatible avec les intégrations côté client (JavaScript SDK) et côté serveur (REST API)

À qui s'adresse cette compétence ?

• Propriétaires de sites e-commerce souhaitant intégrer PayPal au checkout
• Plateformes SaaS proposant la facturation par abonnement
• Places de marché ou plateformes gérant des paiements
• Développeurs créant des flux de paiement personnalisés avec PayPal

Quand l'utiliser ?

Utilisez paypal-integration lorsque vous devez :

• Accepter des paiements PayPal en ligne
• Mettre en place un paiement express pour accélérer les conversions
• Configurer des abonnements ou adhésions récurrents
• Automatiser les remboursements et gérer les litiges
• Recevoir des notifications de paiement asynchrones via IPN/webhooks

Comment l'utiliser

Étapes d'installation

1. Ajoutez la compétence à votre projet avec la Skills CLI :

   npx skills add https://github.com/wshobson/agents --skill paypal-integration

2. Consultez la documentation principale dans SKILL.md pour les détails d'intégration et exemples de workflows.

3. Explorez les fichiers complémentaires tels que README.md, AGENTS.md ainsi que les dossiers rules/, resources/ ou references/ pour des cas d'usage avancés et options de configuration.

Méthodes d'intégration

Côté client (JavaScript SDK)

• Utilisez les PayPal Smart Payment Buttons pour une expérience de paiement hébergée rapide.
• Code backend minimal requis — idéal pour les sites e-commerce simples.

Côté serveur (REST API)

• Contrôle total sur le flux de paiement et l'interface utilisateur.
• Recommandé pour les fonctionnalités avancées, checkout personnalisé ou gestion complexe de la facturation.

Concepts clés

• Produits de paiement : Choisissez entre paiements ponctuels, abonnements ou paiements de masse selon votre modèle commercial.
• IPN (Instant Payment Notification) : Configurez l'IPN pour recevoir des mises à jour en temps réel sur le statut des paiements, remboursements et litiges.

Premiers pas

• Commencez par le fichier SKILL.md pour une vue d'ensemble et des extraits de code pour démarrer rapidement.
• Adaptez les workflows fournis à votre propre dépôt, stack technique et besoins opérationnels.

FAQ

Que fait paypal-integration ?

Cette compétence facilite l'intégration de PayPal pour les paiements en ligne, abonnements et gestion des remboursements. Elle prend en charge les workflows frontend et backend, offrant une grande flexibilité pour divers cas d'usage e-commerce et SaaS.

Ai-je besoin des intégrations client et serveur ?

Vous pouvez choisir l'une ou l'autre selon vos besoins. Le JavaScript SDK convient aux flux de paiement hébergés simples, tandis que le REST API est idéal pour une logique de paiement personnalisée ou avancée.

Où trouver des exemples d'installation et guides avancés ?

Consultez le fichier SKILL.md pour des exemples de démarrage rapide. Pour une intégration plus approfondie, parcourez README.md, AGENTS.md ainsi que les dossiers resources/ ou references/ du dépôt.

Comment gérer les remboursements et litiges ?

La compétence inclut des instructions pour traiter les remboursements et gérer les litiges via l'API PayPal et les notifications IPN. Référez-vous à la documentation pour les détails des workflows.

Comment découvrir toutes les fonctionnalités disponibles ?

Ouvrez l'onglet Fichiers dans le dépôt pour parcourir toute la documentation, scripts d'aide et ressources de référence pour paypal-integration.