Paysafecash

L’API Paiements Paysafe prend en charge Paysafecash en tant qu’instrument de paiement. Vous pouvez traiter les paiements Paysafecash à l’aide de l’API Paiements.

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

• Instrument de paiement : Paysafecash

• Mode de paiement : paiements en ligne en argent comptant

• Types de transactions : paiements

• Authentification de paiement : Clé API pour l’authentification de la requête, autorisation de l’adresse IP du serveur de paiement, certificat X.509 pour l’authenticité de la requête.

Pour traiter une requête de paiement en utilisant Paysafecash comme type de paiement, procédez comme suit :

1. Créez un "payment handle" avec le paramètre transactionType défini sur PAYMENT et le paramètre paymentType défini sur PAYSAFECASH.
2. Comme le client doit compléter l’authentification du paiement en fournissant les détails de Paysafecash, Paysafe renvoie une réponse contenant le message suivant :
   • Le paramètre action est défini sur REDIRECT
   • Un lien payment_redirect pointe vers l’URL de redirection Paysafecash
3. Redirigez le client vers l’URL de redirection Paysafecash afin qu’il puisse générer un code-barres.
4. Lorsque la génération du code-barres est réussie, l’état du "payment handle" devient PAYABLE. Le marchand est informé de ce changement d’état par les webhooks qui ont été configurés.
5. Utilisez le jeton paymentHandleToken renvoyé dans la réponse pour traiter la demande de paiement. Le paiement aura l’état PENDING jusqu’à ce que le client ait effectué le paiement.

Une fois que la requête de paiement a abouti, le marchand en est informé par le biais de webhooks et les fonds sont immédiatement transférés sur le compte du marchand.

Paiement Paysafecash (flux de redirection)

1. Lors du traitement d’une requête de paiement avec Paysafecash comme type de paiement, il convient de suivre les étapes suivantes :

2. Créez un "payment handle" avec le paramètre transactionType défini sur PAYMENT et le paramètre paymentType défini sur PAYSAFECASH.

3. Paysafe fournit la réponse suivante car le client doit compléter l’authentification du paiement en saisissant les données Paysafecash :

   • Le paramètre action est défini sur REDIRECT

   • Un lien payment_redirect pointe vers l’URL de redirection de Paysafecash

4. Redirigez le client vers l’URL de redirection Paysafecash afin qu’il puisse générer un code-barres.

5. L’état du "payment handle" passe à PAYABLE après la génération réussie du code-barres. Cette mise à jour de l’état est communiquée au marchand à l’aide des webhooks qui ont été configurés.

6. Pour traiter la requête de paiement, utilisez le paymentHandleToken fourni dans la réponse. Le paiement aura l’état PENDING jusqu’à ce que le client ait effectué le paiement.

Une fois que la requête de paiement a abouti, le marchand en est informé par le biais de webhooks et les fonds sont immédiatement transférés sur le compte du marchand.

Paiement Paysafecash – flux direct

Lors du traitement d’une requête de paiement avec Paysafecash comme type de paiement, il convient de suivre les étapes suivantes :

1. Créez un "payment handle" avec le paramètre transactionType défini sur PAYMENT et le paramètre paymentType défini sur PAYSAFECASH.

2. Paysafe renvoie une réponse avec le tableau de codes-barres suivant, et l’état du "payment handle" est PAYABLE.

     3. Afficher le code-barres pour l’utilisateur.

     4. Pour compléter la requête de paiement, utilisez le paymentHandleToken renvoyé dans la réponse. L’état du paiement sera PENDING jusqu’à ce que le client effectue le paiement en magasin.

Disponible pour le flux direct et le flux de redirection.

Pour annuler un code-barres, procédez comme suit :

1. Créez un appel HTTP PUT avec identifiant de paiement dans l’URL :
   
   PUT/paymenthub/v1/payments/{paymentId}

2. Transmettez le JSON ci-dessous dans le corps de la requête :
   
   {
        "status": "CANCELLED"
   }

3. Vous recevrez une réponse avec l’état CANCELLED.

4. Vous pouvez vérifier l’état du paiement en utilisant l’appel GET :
   
   GET/paymenthub/v1/payments/{paymentId}

API Localisateur de magasins

Pour trouver les magasins Paysafe :

• Créez un appel GET avec les paramètres suivants.
  
  Vous obtiendrez une liste de magasins dans la réponse.

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.