À propos de PayPal
PayPal en tant que mode de paiement alternatif par redirection permet à vos clients d’effectuer leur paiement en utilisant leur portefeuille/compte PayPal, ce qui les redirigera vers le site de PayPal. Les clients bénéficient ainsi d’une expérience de paiement pratique et rationalisée, ce qui accroît leur satisfaction et leur fidélité. L’intégration vous permettra également de gérer et de rapprocher les transactions PayPal à partir de votre compte Paysafe, réduisant ainsi la nécessité de recourir à plusieurs plateformes de paiement, ce qui permettra de réaliser des économies et d’améliorer l’efficacité opérationnelle.
L’API Paiements Paysafe prend en charge PayPal comme instrument de paiement. Vous pouvez traiter les paiements PayPal à l’aide de l’API Paiements.
Exigences de configuration
Pour accéder à ce service, vous devez d’abord vous inscrire auprès de PayPal.. Veuillez consulter https://developer.paypal.com
Pour que Paysafe puisse créer un compte dans l’environnement de bac à sable et dans l’environnement de production, nous avons besoin des informations suivantes :
- Votre identifiant de client
- Votre clé secrète
- Identifiant de webhook PayPal
- Identifiant de compte PayPal
- Forcer l’intention de vente : Si "true", le paiement est immédiat.
Types de transaction
Nous prenons en charge les types de transactions suivants :
- Paiements
- Retraits
Devise prise en charge
Pays pris en charge
Scénarios habituels
Paiement PayPal
Lorsque vous souhaitez traiter une requête de paiement PayPal, vous devez procéder comme suit :
1. Créez un payment handle avec les paramètres suivants :
- transactionType : PAYMENT
- paymentType : PAYPAL
2. Transmettez les paramètres suivants dans l’objet PAYPAL :
| Paramètre | Description | Obligatoire/Facultatif | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| consumerId | L’identifiant unique du compte PayPal du consommateur ou du payeur. | Facultatif | ||||||||
| recipientDescription | La note au destinataire des fonds dans cette transaction. | Facultatif | ||||||||
| language | Il s’agit de la langue dans laquelle seront localisées les chaînes liées aux erreurs, comme les messages, les problèmes et les actions suggérées. Ex : US | Facultatif | ||||||||
| shippingPreference | Par défaut : "GET_FROM_FILE". La préférence de livraison.
| Facultatif | ||||||||
| consumerMessage | Vous pouvez envoyer une note au payeur pour le paiement | Facultatif | ||||||||
| orderDescription | La description de l’achat. | Facultatif | ||||||||
| recipientType | Type de destinataire de paiement. La seule valeur prise en charge est « PAYPAL_ID ». Le numéro de compte PayPal chiffré. | Facultatif | ||||||||
| userAction | L’action de l’utilisateur présente au client soit le flux de passage à la caisse Continuer ou Terminer l’achat. Vous pouvez opter pour l’un des flux en transmettant les données nécessaires dans userAction dans l’objet PayPal de la requête. 1. Payer maintenant : si vous transmettez "userAction":"COMPLETE_PURCHASE" dans la requête, le flux redirige le client à la page de paiement PayPal et affiche un bouton Terminer l’achat. Lorsque le client clique sur Terminer l’achat, un appel est transmis à Paiement Express à la caisse pour effectuer le paiement sans interaction supplémentaire de la part du client. Choisissez ce flux lorsque vous connaissez le montant du paiement final et que vous ne souhaitez pas afficher l’écran de révision. 2. Passer à l’écran de révision : si vous transmettez "userAction":"CONTINUE” dans la requête, il s’agit du flux par défaut qui redirige le client vers la page de paiement PayPal et affiche le bouton Continuer, après quoi vous devez afficher l’écran suivant en tant qu’écran de révision. Le paiement du client est terminé. Remarque : Si vous ne transmettez pas l’action de l’utilisateur dans l’objet PayPal dans les paramètres de la requête, le flux configuré par défaut est « Passer à la révision ». | Facultatif |
3. Comme le client doit compléter l’authentification du paiement en fournissant ses coordonnées PayPal, Paysafe renvoie une réponse contenant ce qui suit :
- Le paramètre action est défini sur REDIRECT
- Un lien payment_redirect pointe vers l’URL de redirection PayPal.
4. Redirigez le client vers l’URL de redirection PayPal afin qu’il puisse fournir l’adresse courriel et les données du mot de passe pour terminer le transfert d’argent.
5. Lorsque l’authentification du client est réussie, le marchand reçoit une notification à l’URL spécifiée dans le paramètre on_completed inclus dans sa requête.
6. À ce stade, l’état du Payment Handle devient PAYABLE.
Utilisez le paymentHandleToken renvoyé dans la réponse pour traiter la requête de paiement.
Une fois la requête de paiement effectuée avec succès, les fonds sont immédiatement transférés sur votre compte.
Fonctionnalité de règlement automatique
Si vous n’avez pas fait d’appel à l’API Paiements et que vous avez opté pour le règlement automatique, vous pouvez traiter les paiements et les règlements :
- Règlement automatique : au bout de 15 minutes, le système déclenche automatiquement l’appel à l’API Paiements et termine les paiements et les règlements. Le Payment handle expire également.
Pour choisir cette fonctionnalité, envoyez un courriel à l’équipe de soutien aux intégrations à integrations@paysafe.com.
Flux de paiements PayPal
API à utiliser
Retrait Paypal
Lorsque vous souhaitez traiter une requête de retrait Paypal, vous devez procéder comme suit :
1. Créez un Payment Handle avec les paramètres suivants :
- transactionType : STANDALONE_CREDIT
- paymentType : PAYPAL
2. Transmettez les paramètres suivants dans l’objet PAYPAL :
| Paramètre | Description | Obligatoire/Facultatif | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| consumerId | L’identifiant unique du compte PayPal du consommateur ou du payeur. Ceci est obligatoire si vous devez initier des retraits. | Obligatoire | ||||||||
| recipientDescription | La note au destinataire des fonds dans cette transaction. | Facultatif | ||||||||
| language | Il s’agit de la langue dans laquelle seront localisées les chaînes liées aux erreurs, comme les messages, les problèmes et les actions suggérées. Ex : US | Facultatif | ||||||||
| shippingPreference | Par défaut : "GET_FROM_FILE". La préférence de livraison.
| Facultatif | ||||||||
| consumerMessage | Vous pouvez envoyer une note au payeur pour les paiements | Facultatif | ||||||||
| orderDescription | La description des paiements. | Facultatif | ||||||||
| recipientType | Type de destinataire de paiement. La seule valeur prise en charge est « PAYPAL_ID ». Le numéro de compte PayPal chiffré. | Obligatoire |
3. Ce Payment Handle doit immédiatement avoir l’état PAYABLE.
4. Utilisez le jeton paymentHandleToken renvoyé dans la réponse pour traiter la requête de retrait.
La requête de retrait sera traitée par lots et l’état initial sera "Processing".
Une fois la requête de retrait effectuée avec succès, les fonds sont immédiatement transférés sur le compte du client.
Flux de retrait PayPal
