Tester les cartes en mode bac à sable
Le mode bac à sable est un environnement autonome qui reproduit toutes les fonctionnalités d’un environnement réel, à l’exception des paiements réels et des paiements refusés. Pour accéder au mode bac à sable, passez le paramètre “mode”:“sandbox”
lors de l’obtention du jeton.
Pour ouvrir l’interface de paiement, utilisez ce lien en spécifiant le jeton obtenu : https://sandbox-secure.xsolla.com/paystation4/?token={token}
.
En mode bac à sable, vous pouvez tester les scénarios d’interaction de l’interface de paiement suivants lors d’un paiement par carte bancaire :
- paiement test ;
- remboursement ;
- remboursement partiel ;
- blocage d’une transaction frauduleuse ;
- chargeback ;
- enregistrement de carte ;
- suppression de carte enregistrée ;
- prélèvement sur une carte enregistrée ;
- obtention de la liste des cartes enregistrées.
Tester un paiement unique
Effectuer un paiement test
- Ouvrez l'interface de paiement en mode bac à sable.
- Choisissez le mode de paiement Carte bancaire.
- Entrez les informations de la carte bancaire. Dans les autres champs (par exemple, le nom ou l'adresse), entrez n'importe quelle donnée. Vous pouvez également indiquer des informations incorrectes (numéro de carte ou date d'expiration) pour vérifier si une erreur est générée.
- Cliquez sur Pay.
Outre les informations de la carte, vous devez indiquer le code postal si au moins l’une des conditions suivantes est vraie :
- Le pays de l’utilisateur est les États-Unis ou le Canada.
- Le numéro d’identification bancaire (BIN) indique que la carte a été émise aux États-Unis.
Vous pouvez indiquer n’importe quel code postal valide (par exemple, 12345). Il détermine le taux de la taxe de vente, mais n’affecte pas la progression du paiement test.
Les paiements par carte bancaire en mode bac à sable peuvent être effectués dans les devises suivantes : USD, EUR, RUB, GBP, AED, ALL, AMD, ARS, AUD, AZN, BGN, BRL, BYN, CAD, CHF, CLP, CNY, COP, CZK, DKK, DZD, EGP, GEL, HKD, HRK, HUF, IDR, ILS, INR, ISK, JPY, KES, KGS, KRW, KZT, MAD, MDL, MKD, MNT, MXN, MYR, NGN, PEN, PHP, PKR, PLN, RON, RSD, SAR, SEK, SGD, THB, TRY, TWD, UAH, UYU, UZS, VEF, VND, ZAR.
Pour voir les informations détaillées, y compris les frais, sur les transactions effectuées en mode bac à sable :
- Ouvrez votre Compte éditeur.
- Accédez à Accounting > Transaction registry.
- Cochez la case Show test transactions.
Vous pouvez également consulter les détails des transactions et demander des remboursements dans le Compte éditeur dans la section Support > Transaction search.
Remboursement
- Configurez le webhook Refund.
- Effectuez un paiement test avec succès.
- Appelez la méthode API Demander un remboursement.
Une notification de remboursement du paiement est envoyée à l’URL du webhook.
Remboursement partiel
- Configurez le webhook Remboursement partiel.
- Effectuez un paiement test avec succès.
- Appelez la méthode API Demander un remboursement partiel.
Une notification de remboursement partiel du paiement est envoyée à l’URL du webhook.
Bloquer une transaction frauduleuse
- Configurez le webhook AFS rejected transaction.
- Effectuez un paiement test avec cette carte :
Carte | Pays | 3-D Secure |
---|---|---|
Numéro de carte : 5159084825528450 Date d’exp. : 12/40 CVV2 : 3 chiffres aléatoires Marque de carte : Mastercard | États-Unis | Non |
Chargeback
Un appel API distinct a été développé pour le mode bac à sable afin de tester ce scénario sans impliquer une véritable banque.
Pour tester le chargeback :
- Configurez le webhook Refund.
- Effectuez un paiement test avec succès.
- Appelez la méthode Request chargeback.
Vous recevrez un webhook Refund avec le code suivant :
Code | Motif | Description |
---|---|---|
2 | Chargeback | Un chargeback pour une transaction a été demandé. |
Tester les cartes enregistrées
Enregistrer une carte
Vous pouvez tester l’enregistrement d’une carte dans l’interface de paiement :Enregistrer une carte lors d'un paiement test
- Configurez le webhook Ajout de compte de paiement.
- Ouvrez l'interface de paiement en mode bac à sable.
- Sélectionnez le mode de paiement Carte.
- Entrez les informations de la carte bancaire. Vous pouvez également indiquer des informations incorrectes (numéro de carte ou date d'expiration) pour vérifier si une erreur est générée.
- Cochez la case Enregistrer les détails de cette carte pour de futurs paiements.
- Cliquez sur Payer.
Une notification d’ajout d’une nouvelle carte est envoyée à l’URL du webhook.
La carte enregistrée s’affiche dans la section Modes de paiement enregistrés.
Outre les informations de la carte, vous devez indiquer le code postal si au moins l’une des conditions suivantes est vraie :
- Le pays de l’utilisateur est les États-Unis ou le Canada.
- Le numéro d’identification bancaire (BIN) indique que la carte a été émise aux États-Unis.
Vous pouvez indiquer n’importe quel code postal valide (par exemple, 12345). Il détermine le taux de la taxe de vente, mais n’affecte pas la progression du paiement test.
Les paiements par carte bancaire en mode bac à sable peuvent être effectués dans les devises suivantes : USD, EUR, RUB, GBP, AED, ALL, AMD, ARS, AUD, AZN, BGN, BRL, BYN, CAD, CHF, CLP, CNY, COP, CZK, DKK, DZD, EGP, GEL, HKD, HRK, HUF, IDR, ILS, INR, ISK, JPY, KES, KGS, KRW, KZT, MAD, MDL, MKD, MNT, MXN, MYR, NGN, PEN, PHP, PKR, PLN, RON, RSD, SAR, SEK, SGD, THB, TRY, TWD, UAH, UYU, UZS, VEF, VND, ZAR.
Pour voir les informations détaillées, y compris les frais, sur les transactions effectuées en mode bac à sable :
- Ouvrez votre Compte éditeur.
- Accédez à Accounting > Transaction registry.
- Cochez la case Show test transactions.
Vous pouvez également consulter les détails des transactions et demander des remboursements dans le Compte éditeur dans la section Support > Transaction search.
Enregistrer une carte depuis un compte utilisateur
- Configurez le webhook Ajout de compte de paiement.
- Ouvrez l'interface de paiement en mode bac à sable.
- Accédez à Enregistré.
- Cliquez sur l'icône en forme de crayon et choisissez Ajouter un nouveau mode.
- Cliquez sur Carte bancaire.
- Entrez les informations de la carte bancaire. Vous pouvez également indiquer des informations incorrectes (numéro de carte ou date d'expiration) pour vérifier si une erreur est générée.
- Cliquez sur Sauvegarder.
Une notification d’ajout d’une nouvelle carte est envoyée à l’URL du webhook.
La carte enregistrée s’affiche dans la section Modes de paiement enregistrés.
Supprimer une carte enregistrée
Vous pouvez tester la suppression d’une carte enregistrée :Supprimer une carte enregistrée via API
- Configurez le webhook Suppression de compte de paiement.
- Appelez la méthode API Supprimer un compte enregistré.
Une notification de suppression de carte est envoyée à l’URL du webhook.
Supprimer une carte enregistrée dans l'interface de paiement
- Configurez le webhook Suppression de compte de paiement.
- Ouvrez l'interface de paiement en mode bac à sable.
- Accédez à Sauvegarder.
- Cliquez sur l'icône en forme de crayon.
- Cliquez sur Modifier modes de paiement.
- Choisissez une carte et cliquez sur l'icône de la corbeille.
Une notification de suppression de carte est envoyée à l’URL du webhook.
Prélèvement sur une carte enregistrée
Vous pouvez tester un paiement par carte enregistrée :- un prélèvement unique (par exemple, un achat avec une carte enregistrée) ;
- des prélèvements réguliers (par exemple, le paiement d’un abonnement).
Prélèvement sur une carte enregistrée via API
- Configurez le webhook Payment.
- Enregistrez la carte en mode bac à sable.
- Appelez la méthode API Charge with saved account.
Une notification de paiement réussi est envoyée à l’URL du webhook.
Prélèvement sur une carte enregistrée dans l'interface de paiement
- Configurez le webhook Payment.
- Enregistrez la carte en mode bac à sable.
- Ouvrez l'interface de paiement en mode bac à sable.
- Cliquez sur la carte dans la liste des comptes de paiement enregistrés.
- Cliquez sur Payer.
Une notification de paiement réussi est envoyée à l’URL du webhook.
Obtenir la liste des cartes enregistrées
- Enregistrez des cartes en mode bac à sable.
- Appelez la méthode API Lire les comptes enregistrés.
Vous obtiendrez des données masquées dans la réponse.
Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entée.