Cartes de crédit et de débit
Les cartes de crédit et de débit sont le mode de paiement par carte le plus courant. Pour obtenir la liste des systèmes de cartes pris en charge sur Mastercard Gateway, voir les valeurs possibles du champ sourceOfFunds.provided.card.brand dans la référence de l'API.
Pour savoir si la carte utilisée pour effectuer le paiement est une carte de crédit, de débit ou de paiement, envoyez la demande RETRIEVE TRANSACTION (Extraire la transaction) et vérifiez le mode de financement (sourceOfFunds.provided.card.fundingMethod) renvoyé dans la réponse. Vous pouvez utiliser les détails du type de carte pour étayer vos décisions en matière de surcoût.
Prises en charge pour
| Méthodes d'intégration | Transactions |
|---|---|
| Tous | Tous |
Pour connaître les limites des transactions que vous pouvez utiliser avec des méthodes d'intégration spécifiques, voir Hosted Checkout, Hosted Session, Direct Payment et Hosted Batch.
À propos du mode de paiement
Les cartes de crédit offrent une ligne de crédit à leurs titulaires, leur permettant d'effectuer des achats et de les payer plus tard avec des intérêts, tandis que les cartes de débit prélèvent des fonds directement sur le compte bancaire du titulaire de la carte.
Cartes de crédit
Les transactions par carte de crédit constituent la majorité des transactions de paiement dans le domaine du commerce électronique. Les détails de la carte comprennent généralement le nom du payeur, le numéro de carte, l'expiration de la carte et le cryptogramme visuel.
Pendant le processus de paiement,
- Selon la méthode d'intégration, le site Web ou l'application du commerçant collecte les détails de la carte et les envoie à Mastercard Gateway ou le payeur fournit les détails directement à la passerelle par le biais de champs hébergés ou d'une page de paiement hébergée.
- Sur la base du numéro de carte, la passerelle identifie le système de cartes et valide à la fois le numéro de carte et le cryptogramme visuel (CSC).
- Si la validation réussit, le paiement est transféré à la banque acquéreuse.
Par exemple, la passerelle valide le cryptogramme visuel pour le format. Sur les cartes de crédit Visa et Mastercard, le cryptogramme visuel est la valeur à trois chiffres imprimée sur le cadre de signature au dos de la carte.
Pour American Express, ce nombre est la valeur à 4 chiffres imprimée sur le recto, au-dessus du numéro de compte de la carte de crédit.
Cartes de débit
Les paiements par carte de débit sont traités de la même manière que les cartes de crédit. Les données relatives à la carte de débit comprennent généralement le nom du payeur, le numéro de la carte, l'expiration de la carte et le cryptogramme visuel.
Faites attention aux détails suivants de la carte :
- Cartes Maestro - Avec les cartes de débit Maestro, toutes les transactions Internet doivent au moins tenter d'effectuer une authentification 3DS avant d'effectuer une transaction financière. La passerelle traite la transaction en cas de tentative d'authentification et de réception d'une réponse d'authentification différente de « Authentication Failed » (Échec de l'authentification). Si aucune authentification n'est tentée, la passerelle bloque la transaction.
Si la fonctionnalité « Traiter les remboursements Maestro comme des paiements » est configurée pour votre lien commerçant-acquéreur, les transactions Refund (Rembourser) avec la source de transaction INTERNET et la devise de transaction INR seront soumises à l'acquéreur comme des transactions de paiement.
- Cartes MADA - Les cartes MADA sont proposées en Arabie Saoudite en comarquage avec Mastercard et Visa, ainsi que sous la forme de cartes monomarques MADA uniquement. Les paiements effectués avec des cartes comarquées Mada renvoient MADA_MASTERCARD ou MADA_VISA dans le champ localBrand de la réponse de la transaction, tandis que les paiements effectués avec les cartes monomarque Mada uniquement renvoient MADA_ONLY. Toutes les transactions initiées par le titulaire de la carte avec des cartes MADA nécessitent une authentification 3DS.
- Cartes ITMX - Les cartes ITMX sont prises en charge en tant que cartes comarquées avec Mastercard et Visa en Thaïlande. Les paiements traités avec les cartes de débit ITMX renvoient MASTERCARD_ITMX ou VISA_ITMX dans le champ localBrand dans la réponse de transaction. Toutes les transactions initiées par le titulaire de la carte avec des cartes ITMX nécessitent une authentification 3DS.
- Cartes EFTPOS - Les cartes EFTPOS sont prises en charge en tant que cartes comarquée savec Mastercard et VISA en Australie. Les paiements traités au moyen de cartes de débit EFTPOS retournent EFTPOS dans le champ localBrand de la réponse de la transaction.
Principales fonctionnalités prises en charge
Lorsque vous utilisez des cartes de crédit et de débit comme mode de paiement, vous pouvez :
- Effectuer des paiements à l'aide d'un paiement en une seule action ou d'une autorisation en deux étapes et de transactions Capture (Collecter).
- Effectuer des remboursements, des annulations et des décaissements.
- Renseignez-vous et utilisez différentes options de paiement (telles que les échéanciers de paiement et la conversion de devise dynamique).
- Ajoutez des données supplémentaires à vos demandes pour rendre le paiement plus convivial pour le payeur ou faciliter son traitement dans le système de paiement.
Détails de paiement requis
Lorsque vous utilisez des cartes de crédit ou de débit, vous devez fournir les détails de paiement suivants à la passerelle. En fonction de l'intégration utilisée, la passerelle recueille les détails via une page de paiement hébergée, à partir de champs hébergés au sein d'une session ou à partir d'une demande de transaction.
Les détails suivants doivent au moins être fournis :
- Mode de paiement (carte)
- Numéro de carte
- Mois et année d'expiration de la carte
- CSC
Dans une demande de transaction, ces détails sont fournis comme suit :
"sourceOfFunds": {
"type": "CARD",
"provided": {
"card": {
"number": "1000100010001000",
"expiry": {
"month": "10",
"year": "26"
},
"securityCode" : "123"
}
}
}
Conditions préalables
Pour utiliser les cartes de crédit et de débit comme mode de paiement :
- Votre acquéreur doit être en mesure de traiter les paiements par débit et par crédit.
- Vous devez convenir avec votre acquéreur des systèmes de cartes que vous êtes autorisé à accepter.
- Votre Your payment service provider doit configurer en conséquence le lien acquéreur-commerçant dans votre profil de commerçant.
Ajouter la méthode à votre intégration
Aucune personnalisation supplémentaire n'est nécessaire pour ajouter les cartes de crédit et de débit à votre intégration APRÈS l'implémentation de votre intégration générique sélectionnée. Pour des exemples de demandes transaction par carte de crédit ou de débit, téléchargez la collection Postman.
Tester la méthode
Pour plus d'informations sur les tests d'intégration des cartes de crédit et de débit, voir Cartes de test, ainsi que les instructions de test pour chaque méthode d'intégration applicable.