Paysafecard

PaysafeCard est un mode de paiement alternatif très répandu qui permet aux clients d’effectuer des achats en ligne sans avoir besoin d’un compte bancaire ou d’une carte de crédit. Les utilisateurs peuvent acheter des bons prépayés auprès de détaillants agréés et les échanger ensuite sur diverses plateformes en ligne, notamment des sites de jeux, de commerce électronique et de divertissement. Grâce à sa grande disponibilité et à sa facilité d’utilisation, PaysafeCard offre une solution sûre et pratique aux clients qui recherchent une option de paiement flexible pour leurs transactions en ligne.

Fonctionnalités

1. Largement acceptée dans tous les secteurs : PaysafeCard est largement acceptée par diverses plateformes en ligne, qu’il s’agisse de jeux, de commerce électronique ou de divertissement.

2. Transactions sécurisées et privées : Avec PaysafeCard, les utilisateurs peuvent effectuer des achats en ligne sans communiquer d’informations personnelles ou financières.

3. Aucun compte bancaire ou carte de crédit n’est nécessaire : PaysafeCard élimine la nécessité de recourir aux services bancaires traditionnels, ce qui la rend accessible à tous.

4. Montants de paiement flexibles : les utilisateurs peuvent choisir la dénomination souhaitée pour les bons prépayés, ce qui permet de personnaliser les options de paiement.

5. Accessibilité pratique : les bons PaysafeCard peuvent être facilement obtenus auprès des détaillants agréés ou de canaux en ligne, ce qui garantit une large disponibilité.

L’API Paiements répond aux besoins suivants de Paysafecard :

• Instrument de paiement : Paysafecard, compte Paysafecard et Scan to Pay. 
• Mode de paiement prépayé : payez en ligne sans saisir d’informations personnelles, de coordonnées bancaires ni de données de carte de crédit. 
• Types de transactions : paiements, retraits et remboursements 
• Authentification de paiement : protection par NIP (conformité à la directive sur les services de paiement 2 (DSP2))

Pour connaître la disponibilité des produits, cliquez ici.

Pour traiter une demande de paiement en utilisant Paysafecard comme mode de paiement : 

1. Créez un Payment handle avec les paramètres suivants :
   transactionType : PAYMENT
   paymentType : PAYSAFECARD
   POST: paymenthub/v1/paymenthandles
2. Nous renvoyons une réponse avec les informations suivantes :
   • Le paramètre action est défini sur REDIRECT
   • Un lien payment_redirect pointe vers l’URL de redirection de la page PaysafeCard
   • L’état du Payment handle passe à INITIATED.
3. Une fois le client redirigé à l’aide de payment_redirect sur la page PaysafeCard, il dispose de différentes options de paiement en fonction de la configuration du marchand et de la devise de la transaction :
   • NIB à 16 chiffres
   • Compte PaysafeCard 
   • Scan to Pay
     Remarque : Seul le paiement avec l’option de compte Paysafecard rend l’utilisateur admissible au service de versement.
     
4. En fonction de l’état de la transaction, le client est redirigé vers la page de succès ou d’échec.
   • L’état du Payment handle passe à PAYABLE après une transaction réussie et à FAILED si la transaction échoue.
   • Vous êtes informé du changement d’état par le biais d’un webhook configuré.
5. Utilisez le paymentHandleToken renvoyé dans la réponse pour traiter la requête de paiement.
   POSTpaymenthub/v1/payments

6. Dans la réponse à l’appel de l’API Paiements, en fonction de votre compte configuré chez PaysafeCard, de la devise de traitement et de l’action du client, la réponse contient ces paramètres. 

   • L’Id renvoyé dans la réponse est l’identifiant du paiement, et il est identique à l’identifiant du règlement si settleWithAuth est défini sur TRUE, et doit être stocké de votre côté pour une utilisation future, car paymentId est utilisé directement lors des remboursements.

   • Si la requête d’API Paiements a été effectuée avec settleWithAuth défini sur FALSE, l’API Règlement peut être appelée séparément.
     • POST: paymenthub/v1/settlements
     • Dans un tel cas, un Id nouveau et distinct de l’ID Paiements est renvoyé dans la réponse et doit être stocké du côté marchand pour utilisation ultérieure puisque settlementId est utilisé directement pour les remboursements et pas paymentId. 

Les paiements par paysafecard permettent de transférer des fonds aux titulaires de compte my Paysafecard. Le versement est effectué par le partenaire commercial à la demande du client.

Les versements ne sont actuellement possibles que pour les détenteurs de comptes Paysafecard dans les pays suivants : Allemagne, Autriche, Belgique, Bulgarie, Chypre, Croatie, Danemark, Espagne, Finlande, France, Géorgie, Grèce, Hongrie, Irlande, Italie, Lettonie, Luxembourg, Malte, Norvège, Pays-Bas, Pologne, Portugal, République tchèque, Roumanie, Slovaquie, Slovénie, Suède, Suisse, Royaume-Uni.

Pour traiter une requête de retrait Paysafecard :

1. Créez un Payment handle avec les paramètres suivants :
   transactionType : PAYMENT
   paymentType : PAYSAFECARD
   POST:paymenthub/v1/paymenthandles

2. La requête nécessite deux objets 

   • paysafecard qui prendra 2 paramètres

   • l’objet profile de la requête qui prendra 4 paramètres. 

3. Dans la réponse, un jeton à usage unique sera reçu avec la balise paymentHandleToken, et l’état passe à PAYABLE, ce jeton est ensuite transmis à l’API Crédits autonomes. 
   POST: paymenthub/v1/standalonecredits
4. La réponse finale contiendra les détails de la transaction avec des paramètres tels que
   • id – identifiant unique chez Paysafe
   • gatewayReconciliationId – identifiant unique chez Skrill
   • l’état de la transaction qui peut être utilisé pour références ultérieures.
5. L’état du retrait sera d’abord PENDING et passera à COMPLETED une fois que le remboursement aura été effectué sur le compte bancaire du client; à chaque étape, un webhook sera envoyé au marchand. 

Pour traiter une transaction de remboursement à l’aide de PaysafeCard :

Vous ne pouvez initier une transaction de remboursement que pour une transaction dont le règlement/paiement est terminé.

1. Une fois le paiement et le règlement effectué
   • L’état est COMPLETED dans la réponse des informations sur le paiement
   • Le remboursement peut être initié à l’aide de l’identifiant de règlement qui est le même que l’identifiant de paiement si settleWithAuth est défini sur TRUE.
2. Créez une requête de remboursement à l’aide de l’API Remboursements. 
   POST: /paymenthub/v1/settlements/{settlementId }/refunds
3. La réponse contient des détails sur le paiement et un identifiant unique qui peut être utilisé pour se référer à chaque remboursement individuel, partiel ou total.
4. L’état du remboursement sera d’abord PENDING et passera à COMPLETED une fois que le remboursement aura été effectué sur le compte bancaire du client; à chaque étape, un webhook sera envoyé au marchand. 

Remarque : Une transaction de remboursement ne peut être initiée que par le marchand et pour une transaction dont le règlement/paiement est terminé. Les remboursements partiels ne sont pas possibles.

Paramètres de réponse de l’API Paiements

objet paysafecard

objet profile

Test des valeurs d’identification du client

L’identifiant du client, également connu sous le nom de « identifiant de marchand du client », est un paramètre important pour l’intégration de paysafecard. L’identifiant du client identifie le client du côté de nos partenaires commerciaux. L’identifiant client optimal est une valeur totalement aléatoire. Une valeur qui identifie le client de manière unique et qui est déconnectée de toute information personnelle. Cette valeur d’identification du client doit être la même pour toutes les transactions du client. Voici des lignes directrices concernant les identifiants de clients possibles :

Valeurs valides :

Valeurs non valides :

L’envoi de valeurs non valides, sous quelque forme que ce soit, ne sera pas accepté. Si vous avez l’intention de traiter des transactions paysafecard sur plusieurs marques, veuillez vous renseigner sur les possibilités de séparer plusieurs entités pour votre compte.

Payment Handle

1. PAYMENT_HANDLE_PAYABLE : ce webhook signale que le jeton du payment handle créé aux fins requises peut maintenant être exécuté et que les exigences préliminaires sont remplies, et que le prochain appel d’API avec le payment handle peut être effectué.
2. PAYMENT_HANDLE_PROCESSING : ce webhook est déclenché lorsque l’utilisateur est redirigé avec succès vers la page de la plateforme de paiement et que l’opération a commencé pour le paiement par l’utilisateur.
3. PAYMENT_HANDLE_COMPLETED : ce webhook est déclenché lorsque le processus du payment handle est terminé après avoir déclenché l’API suivante, Paiements ou Crédit autonome.
4. PAYMENt_HANDLE_EXPIRED : ce webhook est déclenché lorsque l’étape suivante n’est pas lancée après la création du payment handle dans le délai imparti. La durée peut être consultée dans la réponse à l’API /paymenthub/v1/paymenthandles sous la balise timeToLiveSeconds.

Paiements

1. PAYMENT_PROCESSING : le paiement est en cours. Dans certains cas, il peut y avoir des retards dus à une action en cours de votre part ou de la part du client. 
2. PAYMENT_PENDING : le paiement est en attente parce que la transaction n’a pas été complétée entre le compte bancaire, le portefeuille Skrill et vous.
3. PAYMENT_COMPLETED/SETTLEMENT_COMPLETED : le paiement a été effectué avec succès.
4. PAYMENT_FAILED : ce webhook est déclenché lorsque le paiement échoue en cours du processus.

Règlement

1. SETTLEMENT_FAILED : ce webhook est déclenché dans le cas où la transaction a été initialement terminée et a ensuite échoué en raison d’une erreur de règlement.
2. SETTLEMENT_CANCELLED : ce webhook est déclenché lorsque la transaction a été annulée après avoir été effectuée.
3. SETTLEMENT_ERRORED : ce webhook est utilisé en cas d’erreur technique lors de l’initiation d’une transaction.
4. SETTLEMENT_PENDING : ce webhook est déclenché lorsque le retrait a été initié mais qu’en raison de divers délais bancaires ou de problèmes de fuseau horaire, le transfert d’argent n’a pas eu lieu.

Crédits autonomes/retraits

1. SA_CREDIT_FAILED : ce webhook est déclenché dans le cas où la transaction a été initialement terminée et a ensuite échoué en raison d’une erreur de règlement.
2. SA_CREDIT_CANCELLED : ce webhook est déclenché lorsque la transaction a été annulée après avoir été effectuée.
3. SA_CREDIT_ERRORED : ce webhook est utilisé en cas d’erreur technique lors de l’initiation d’une transaction.
4. SA_CREDIT_PENDING : ce webhook est déclenché lorsque le retrait a été initié mais qu’en raison de divers délais bancaires ou de problèmes de fuseau horaire, le transfert d’argent n’a pas eu lieu.

Remboursements

1. REFUND_FAILED : ce webhook est déclenché lorsque le remboursement est initié mais a échoué en raison d’une erreur fonctionnelle, le montant du remboursement étant supérieur au montant du paiement.
2. REFUND_COMPLETED : ce webhook est déclenché lorsque le remboursement a été transféré avec succès du compte du marchand vers le compte bancaire choisi par l’utilisateur.
3. REFUND_PENDING : ce webhook est déclenché lorsque le remboursement a été initié mais qu’en raison de divers délais bancaires ou de problèmes de fuseau horaire, le transfert d’argent n’a pas eu lieu.