L’API Paiements Paysafe prend en charge les cartes en tant qu’instrument de paiement. Vous pouvez traiter les cartes de crédit et de débit et les enregistrer ou segmenter en unités dans un profil de client afin de facturer les clients ultérieurement.

Les paiements répondent aux besoins suivants pour les cartes :

• Instrument de paiement : cartes de crédit et cartes de débit
• Cartes prises en charge : Visa, Visa Debit, Visa Electron, Visa Prepaid, American Express, Mastercard, Mastercard Debit (Maestro), Mastercard Prepaid, Discover.
• Types de transaction : paiements et remboursements
• Authentification de paiement : Dynamic 3D Secure 2 (prêt pour l’authentification forte du client)

Cette section présente quelques scénarios courants de configuration de requêtes de paiement et de crédit.

Scénario 1 : Paiement par carte et règlement

L’autorisation et le règlement d’un paiement par carte de crédit sont effectués en une seule requête. Elle est généralement utilisée pour fournir un service immédiat. Par exemple, un marchand de jeux où un client dépose de l’argent sur son compte. En règle générale, vous devez procéder comme suit :

1. Créez un "payment handle" dont l’état immédiat est PAYABLE.
2. Utilisez le paymentHandleToken renvoyé en réponse au traitement de la requête de paiement – définissez le paramètre settleWithAuth sur « true ».
3. Lorsque la requête de paiement est acceptée, les fonds sont immédiatement demandés à l’émetteur de la carte lors de l’exécution du prochain règlement par lot Paysafe.

Paiement par carte avec règlement et authentification 3D Secure

L’autorisation et le règlement sont effectués en une seule requête. L’authentification 3D Secure est également effectuée avant l’autorisation du paiement.

En règle générale, vous devez procéder comme suit :

1. Créer un "payment handle"
2. Paysafe renvoie la réponse suivante :
   • Le paramètre action est défini sur REDIRECT (puisque 3D Secure est activé)
   • Un lien payment_redirect renvoie à l’URL d’authentification 3D Secure
3. Redirigez le client vers l’URL d’authentification 3D Secure.
4. Lorsque l’authentification est réussie, le marchand reçoit une notification à l’adresse URL spécifiée dans le paramètre on_completed compris dans sa requête.
5. L’état du "payment handle" passe à PAYABLE.
6. Utilisez le paymentHandleToken renvoyé en réponse au traitement de la requête de paiement – définissez le paramètre settleWithAuth sur « true ».
7. Lorsque la requête de paiement est acceptée, les fonds sont immédiatement demandés à l’émetteur de la carte lors de l’exécution du prochain règlement par lot Paysafe.

Paiement par carte avec règlement différé

Un marchand reçoit une autorisation d’achat pour un montant donné et la règle après que le service a été exécuté. Un exemple serait celui d’un marchand qui expédie des marchandises après avoir pris une commande en ligne le premier jour suivant l’autorisation, mais qui la règle le troisième jour lorsqu’il envoie les produits que vous avez achetés. En règle générale, vous devez procéder comme suit :

Par exemple, un marchand prend une commande en ligne le premier jour après l’autorisation et la règle le troisième jour après l’expédition des marchandises.

1. Créez un "payment handle" dont l’état immédiat est PAYABLE.
2. Utilisez le paymentHandleToken renvoyé en réponse au traitement de la requête de paiement – définissez le paramètre settleWithAuth sur « false ».
3. Utilisez le même paymentHandleToken pour traiter une requête de règlement après l’expédition des marchandises. Le payment_id à inclure dans l’URL de la requête de règlement est renvoyé en réponse à la requête de paiement.
4. Les fonds sont immédiatement demandés à l’émetteur de la carte lors de la prochaine exécution du règlement par lot Paysafe, une fois la requête de règlement terminée.

Paiement par carte d’un crédit initial

La requête de crédit initial permet à un marchand d’émettre un crédit à un client lorsqu’aucun paiement antérieur n’est lié à ce crédit, comme c’est le cas pour un remboursement ordinaire. Par exemple, un marchand de jeux en ligne peut vouloir effectuer un paiement à l’aide d’un crédit initial. Dans ce cas, vous devez procéder comme suit :

1. Créez un "payment handle", avec le paramètre transactionType défini sur ORIGINAL_CREDIT. Ce "payment handle" doit immédiatement avoir l’état PAYABLE.
2. Utilisez le paymentHandleToken renvoyé en réponse pour traiter le crédit initial.

Une fois que la requête de crédit initial a été traitée avec succès, les fonds sont transférés sur la carte du client lors de l’exécution du lot Paysafe suivant.

Vous pouvez utiliser l’un des numéros de carte suivants pour tester l’API Paiements Paysafe.

Date d’expiration

Lorsque vous utilisez les numéros de cartes de test, vous pouvez utiliser n’importe quelle date dans le futur pour la date d’expiration (p. ex. 11/22).

CVV

Vous pouvez utiliser n’importe quel nombre à 3 chiffres pour le CVV dans l’environnement de test du marchand. Toutefois, si vous souhaitez générer une réponse de correspondance CVV spécifique, vous devrez utiliser les valeurs suivantes.

Simuler des réponses d’autorisation

Vous pouvez simuler la réponse à une requête d’autorisation de carte en spécifiant différents montants inférieurs à 1,00 $ dans la requête. Pour les tests réguliers, n’utilisez pas de montants inférieurs à 1,00 $ (100 en unités mineures), car cela déclenchera différents cas de refus ou de retard.

Résultats de 3D Secure 3 et transfert de responsabilité

Lorsque 3D Secure est utilisé en conjonction avec une requête d’autorisation via l’API Paiements par carte, exigeant du client qu’il authentifie la carte utilisée lors de la transaction, un avantage majeur pour le marchand est qu’en cas de paiement contesté, la responsabilité financière peut être transférée du marchand à l’émetteur de la carte. De nombreux facteurs influent sur ce transfert de responsabilité. Les marchands doivent donc prendre contact avec leur gestionnaire de compte pour obtenir des conseils.