- Directives d'intégration
- Fonctionnalités prises en charge
- Paiements des frais de transit cumulés
Transit – Paiements agrégés des titres de transport
Les frais de transit cumulés apportent une aide dans les scénarios où vous ne connaissez pas, au début du trajet, le prix final qui sera facturé Dans ces scénarios, le prix final est calculé à la fin d'une période de transport, généralement de 24 heures, sur la base des trajets effectués pendant cette période. Cette page décrit les cas d'utilisation des frais de transit cumulés et le processus permettant de soumettre une demande valide à la passerelle. Vous devez soumettre des demandes différentes pour les cartes Mastercard et Visa. Pour les cartes American Express, suivez les instructions fournies pour Mastercard. Via le système de paiements agrégés des titres de transport,
- vous pouvez cumuler les frais des transactions du payeur pour les différents trajets pour une certaine période et jusqu'à un certain montant, et
- vous pouvez facturer des frais forfaitaires, basés sur la distance ou sur le temps pour chaque trajet au cours de la période.
Les services Mastercard Gateway prennent en charge la fonctionnalité de frais de transit cumulés pour
- traiter une transaction EMV et des paiements mobiles sans contact à compter de la version 66 de l'API WS,
- les cartes Mastercard, hors cartes Maestro, conformément aux règles du système Mastercard,
- les cartes Visa, conformément aux règles du système Visa, et
- les cartes American Express, conformément aux règles du système Mastercard.
Conditions préalables
Pour soumettre des transactions de frais de transit cumulés, votre code de catégorie du commerçant (MCC) doit être l'un des suivants :
Mastercard
- 4111 - Transport - Transport suburbain et local de passagers, y compris les ferries
- 4131 - Lignes d'autobus
- 4784 - Frais de ponts, routes et péages
- 7523 - Parcs de stationnement et garages pour automobiles
Visa
- 4111 - Transport de passagers local et suburbain, y compris les ferries
- 4112 - Chemins de fer pour passagers
- 4131 - Lignes d'autobus
American Express
- 4111 - Transport de passagers local et suburbain, y compris les ferries
- 4112 - Chemins de fer pour passagers
- 4131 - Lignes d'autobus
- 4784 - Péages et droits de pont
- 7523 - Parcs de stationnement et garages
Effectuez une certification EMV selon les règles du système applicable. Votre Your payment service provider doit vous permettre de
- soumettre des transactions Capture (Collecter) excessives, et
- extraire les numéros de cartes non masqués.
Paiements EMV sans contact vs paiements mobiles sans contact
La prise en charge de la fonctionnalité de frais de transit cumulés est proposée pour
- les paiements EMV sans contact, où les payeurs présentent leur carte de crédit au terminal,
- les paiements mobiles sans contact, où les payeurs présentent leurs appareils, tels qu'un téléphone portable ou une montre, au terminal.
Paiements mobiles sans contact
Pour les paiements mobiles sans contact, vous ne recevrez du terminal que les détails du DPAN (Primary Account Number) spécifique à l'appareil et non les détails du FPAN (Funding Primary Account Number). Partout où la demande Autorization (Autorisation) contient un DPAN, la réponse de la transaction contiendra
- le DPAN tel qu'indiqué dans la demande dans le champ
sourceOfFunds.provided.card.deviceSpecificNumber - l'année et le mois d'expiration du DPAN tels qu'indiqués dans la demande dans les champs
sourceOfFunds.provided.card.deviceSpecificExpiry.yearetsourceOfFunds.provided.card.deviceSpecificExpiry.month - le FPAN tel que retourné par le système dans le champ
sourceOfFunds.provided.card.number, et - l'année et le mois d'expiration du FPAN tels que retournés par le système dans les champs
sourceOfFunds.provided.card.expiry.yearetsourceOfFunds.provided.card.expiry.month.
responseControls.sensitiveData=UNMASK dans la demande Retrieve Transaction (Extraire transaction).
Identification du compte de paiement
La prise en charge par la passerelle de l'alimentation de la référence du PAR (Payment Account Reference) dans la réponse de la transaction a été ajoutée à compter de la version 65 de l'API. Pour les réponses de transaction RETRIEVE_TRANSACTION et RETRIEVE_ORDER : le PAR est retourné dans le champ sourceOfFunds.provided.card.paymentAccountReference.
Scénarios
Vous trouverez ci-dessous plusieurs scénarios pour le traitement des paiements de frais de transit cumulés conformément aux règles du système.
Première utilisation d'une nouvelle carte
Carte Mastercard ou American Express
Considérez ce scénario comme celui de la première utilisation au cours de la période de transport.
Carte Visa
Pour vérifier que la carte est valide, soumettez la demande Verify (Vérifier) avec les détails suivants :
- un identifiant pour la commande dans le champ
order.id - un identifiant unique dans la commande pour la transaction Verification (Vérification) dans le champ
transaction.id - aucun montant de commande dans le champ
order.amountou le champorder.amount=0 - la devise de la commande dans le champ
order.currency - le champ
sourceOfFunds.provided.card.emvRequestavec des données de balise EMV valides de la première utilisation au cours de la période de transport transaction.source=CARD_PRESENTposTerminal.attended=UNATTENDEDposTerminal.location=MERCHANT_TERMINAL_ON_PREMISESposTerminal.cardholderActivated=SELF_SERVICE_TERMINALposTerminal.inputCapability=CONTACTLESS_CHIPposTerminal.panEntryMode=CONTACTLESSposTerminal.pinEntryCapability=PIN_NOT_SUPPORTEDposTerminal.lane=99991111posTerminal.cardPresenceCapability=CARD_PRESENT
Vous trouverez ci-dessous un exemple REST de vérification de carte avant le début d'une période de transport.
| URL | https://na-gateway.mastercard.com/api/rest/version/66/merchant/CYG_S2I_MER2/order/{{order_id}}/transaction/{{transaction_id}} |
| Méthode HTTP | PUT |
{
"apiOperation": "VERIFY",
"order": {
"amount": "0.00",
"currency": "AUD"
},
"posTerminal": {
"address": {
"country": "AUS",
"postcodeZip": "4000"
},
"attended": "UNATTENDED",
"cardPresenceCapability": "CARD_PRESENT",
"cardholderActivated": "SELF_SERVICE_TERMINAL",
"inputCapability": "CONTACTLESS_CHIP",
"lane": "99991111",
"location": "MERCHANT_TERMINAL_ON_PREMISES",
"panEntryMode": "CONTACTLESS",
"pinEntryCapability": "PIN_NOT_SUPPORTED"
},
"sourceOfFunds": {
"provided": {
"card": {
"emvRequest": {
"5F2A": "036",
"5F34": "099",
"82": "0000",
"84": "010101010101",
"95": "0000000000",
"9A": "161021",
"9B": "0101",
"9C": "00",
"9F02": "000000010000",
"9F03": "000000000000",
"9F10": "06011103A000000A0100000000000BB0ABAD",
"9F1A": "036",
"9F1E": "0123ABCD",
"9F26": "D1F722D47FCA8273",
"9F27": "40",
"9F33": "E0B8C8",
"9F34": "1E0300",
"9F35": "12",
"9F36": "0002",
"9F37": "2A4E1690",
"9F6E": "0101"
},
"expiry": {
"month": "12",
"year": "39"
},
"track2": "400555xxxxxx0019=391220xxxx06711"
}
},
"type": "CARD"
},
"transaction": {
"source": "CARD_PRESENT"
}
}
Vous pouvez soumettre cette demande
- lorsqu'une carte est utilisée pour la première fois
- à intervalles réguliers pour vous assurer que la carte est toujours valide, ou
- la première fois qu'une carte est utilisée après son retrait de la liste des refus.
Première utilisation au cours de la période de transport
Carte Mastercard ou American Express
Pour autoriser le paiement des frais de transit cumulés pour cette carte, soumettez la demande Authorization (Autorisation) avec les détails suivants :
- un identifiant pour la commande dans le champ
order.id - un identifiant unique dans la commande pour la transaction Authorization (Autorisation) dans le champ
transaction.id - un montant nominal dans le champ
order.amount - la devise de la commande dans le champ
order.currency transaction.transit.aggregatedFare.type=FAREtransaction.transit.aggregatedFare.transportationMode with a valid enumeration value that reflects the transportation mode used by the payer for the first trip- le champ
transaction.transit.aggregatedFare.aggregationStartDateavec une date de début valide pour le trajet - le champ
sourceOfFunds.provided.card.emvRequestavec des données EMV valides de la première utilisation au cours de la période de transport transaction.source=CARD_PRESENTposTerminal.attended=UNATTENDEDposTerminal.location=MERCHANT_TERMINAL_ON_PREMISESposTerminal.cardholderActivated=SELF_SERVICE_TERMINALposTerminal.inputCapability=CONTACTLESS_CHIPposTerminal.panEntryMode=CONTACTLESSposTerminal.pinEntryCapability=PIN_NOT_SUPPORTEDposTerminal.lane=99991111posTerminal.cardPresenceCapability=CARD_PRESENT
Vous trouverez ci-dessous un exemple REST de demande Authorization (Autorisation) nominale pour le cumul des frais de transit.
| URL | https://na-gateway.mastercard.com/api/rest/version/66/merchant/CYG_S2I_MER2/order/{{order_id}}/transaction/{{transaction_id}} |
| Méthode HTTP | PUT |
{
"apiOperation": "AUTHORIZE",
"order": {
"amount": "1.00",
"currency": "AUD"
},
"posTerminal": {
"address": {
"country": "AUS",
"postcodeZip": "4000"
},
"attended": "UNATTENDED",
"cardPresenceCapability": "CARD_PRESENT",
"cardholderActivated": "SELF_SERVICE_TERMINAL",
"inputCapability": "CONTACTLESS_CHIP",
"lane": "99991111",
"location": "MERCHANT_TERMINAL_ON_PREMISES",
"panEntryMode": "CONTACTLESS",
"pinEntryCapability": "PIN_NOT_SUPPORTED"
},
"sourceOfFunds": {
"provided": {
"card": {
"emvRequest": {
"5F2A": "036",
"5F34": "099",
"82": "0000",
"84": "010101010101",
"95": "0000000000",
"9A": "161021",
"9B": "0101",
"9C": "00",
"9F02": "000000010000",
"9F03": "000000000000",
"9F10": "06011103A000000A0100000000000BB0ABAD",
"9F1A": "036",
"9F1E": "0123ABCD",
"9F26": "D1F722D47FCA8273",
"9F27": "40",
"9F33": "E0B8C8",
"9F34": "1E0300",
"9F35": "12",
"9F36": "0002",
"9F37": "2A4E1690",
"9F6E": "0101"
},
"expiry": {
"month": "12",
"year": "39"
},
"track2": "545721xxxxxx0012=391220xxxxx6711"
}
},
"type": "CARD"
},
"transaction": {
"source": "CARD_PRESENT",
"transit": {
"aggregatedFare": {
"type": "FARE",
"aggregationStartDate": "2020-05-05",
"transportationMode": "TRAIN"
}
}
}
"responseControls":{
"sensitiveData": "UNMASK"
}
}
Si la demande a abouti, cumulez les frais de transit pour cette carte. Si la demande échoue, ajoutez la carte à la liste des refus et lancez un recouvrement de la dette pour les frais de ce trajet.
Carte Visa
Cumulez les frais de transit pour cette carte et assurez-vous de collecter les données d'utilisation pour ce trajet
Utilisations suivantes au cours de la période de transport
Carte Mastercard ou American Express
Ajoutez les frais de transit pour chaque trajet aux frais de transit cumulés pour cette carte. À la fin de la période de transport, soumettez la demande Capture (Collecter) pour le total des frais de transit cumulés.
Carte Visa
Ajoutez les frais de transit pour chaque trajet aux frais de transit cumulés pour cette carte. À la fin de la période de transport, soumettez une demande Authorization (Autorisation) pour le total des frais de transit cumulés. Assurez-vous de collecter les données d'utilisation pour chaque trajet.
Fin de la période de transport
Carte Mastercard ou American Express
À la fin de la période de transport, vous pouvez collecter le total des frais de transit cumulés au cours de la période de transport en soumettant la demande Capture (Collecter) avec les détails suivants :
- l'identifiant de la commande de la transaction Authorization (Autorisation) réussie dans le champ order.id
- un identifiant de transaction unique dans la commande pour la transaction Capture (Collecter) dans le champ transaction.id
- les frais de transit cumulés pour cette période de transport dans le champ transaction.amount, et
- la devise de la commande, identique à celle de la transaction Authorization (Autorisation), dans le champ intransaction.currency.
Vous trouverez ci-dessous un exemple REST de demande Capture (Collecter) pour les frais de transit cumulés.
Ne soumettez pas à nouveau d'autres détails de paiement dans la demande Capture (Collecter) car la passerelle stocke les détails de paiement pour chaque commande.
| URL | https://na-gateway.mastercard.com/api/rest/version/66/merchant/CYG_S2I_MER2/order/{{order_id}}/transaction/{{transaction_id}} |
| Méthode HTTP | PUT |
{
"apiOperation": "CAPTURE",
"transaction": {
"amount": "15.00",
"currency": "AUD"
}
}
Le payeur peut à nouveau utiliser la carte au cours de la période de transport suivante. Il existe différentes limites au montant que vous pouvez collecter et appliquer en fonction de votre pays. Pour plus d'informations sur les règles, voir les règles du système Mastercard.
Carte Visa
À la fin de la période de transport, vous pouvez autoriser le total des frais de transit cumulés au cours de la période de transport en soumettant la demande Authorization (Autorisation) avec les détails suivants :
- un identifiant pour la commande dans le champ order.id (vous pouvez soumettre cette demande avec le même ID de commande que vous avez utilisé pour la demande Verify (Vérifier) lors de la première utilisation de cette carte ou utiliser un nouvel ID de commande)
- un identifiant unique dans la commande pour la transaction Authorization (Autorisation) dans le champ transaction.id
- les frais de transit cumulés pour cette période de transport dans le champ order.amount
- la devise de la commande dans le champ order.currency
- le champ transaction.transit.aggregatedFare.type=FARE
- le champ transaction.transit.aggregatedFare.transportationMode avec une valeur d'énumération valide qui reflète le mode de transport utilisé par le payeur pour le premier trajet
- le champ transaction.transit.aggregatedFare.aggregationStartDate avec une date de début valide pour le trajet
- le champ sourceOfFunds.provided.card.emvRequest avec des données EMV valides de la dernière utilisation au cours de la période de transport
- le champ sourceOfFunds.provided.card.sequenceNumber
- le champ transaction.source=CARD_PRESENT
- le champ posTerminal.attended=UNATTENDED
- le champ posTerminal.location=MERCHANT_TERMINAL_ON_PREMISES
- le champ posTerminal.cardholderActivated=SELF_SERVICE_TERMINAL
- le champ posTerminal.inputCapability=CONTACTLESS_CHIP
- le champ posTerminal.panEntryMode=CONTACTLESS
- le champ posTerminal.pinEntryCapability=PIN_NOT_SUPPORTED
- le champ posTerminal.lane=99991111
- le champ posTerminal.cardPresenceCapability=CARD_PRESENT
Vous trouverez ci-dessous un exemple REST de demande Authorization (Autorisation) du total des frais de transit cumulés.
| URL | https://na-gateway.mastercard.com/api/rest/version/66/merchant/CYG_S2I_MER2/order/{{order_id}}/transaction/{{transaction_id}} |
| Méthode HTTP | PUT |
{
"apiOperation": "AUTHORIZE",
"order": {
"amount": "15.00",
"currency": "AUD"
},
"posTerminal": {
"address": {
"country": "AUS",
"postcodeZip": "4000"
},
"attended": "UNATTENDED",
"cardPresenceCapability": "CARD_PRESENT",
"cardholderActivated": "SELF_SERVICE_TERMINAL",
"inputCapability": "CONTACTLESS_CHIP",
"lane": "99991111",
"location": "MERCHANT_TERMINAL_ON_PREMISES",
"panEntryMode": "CONTACTLESS",
"pinEntryCapability": "PIN_NOT_SUPPORTED"
},
"sourceOfFunds": {
"provided": {
"card": {
"emvRequest": {
"5F2A": "036",
"5F34": "099",
"82": "0000",
"84": "010101010101",
"95": "0000000000",
"9A": "161021",
"9B": "0101",
"9C": "00",
"9F02": "000000010000",
"9F03": "000000000000",
"9F10": "06011103A000000A0100000000000BB0ABAD",
"9F1A": "036",
"9F1E": "0123ABCD",
"9F26": "D1F722D47FCA8273",
"9F27": "40",
"9F33": "E0B8C8",
"9F34": "1E0300",
"9F35": "12",
"9F36": "0002",
"9F37": "2A4E1690",
"9F6E": "0101"
},
"expiry": {
"month": "12",
"year": "39"
},
"track2": "400555xxxxxx0019=391220xxxxx6711"
}
},
"type": "CARD"
},
"transaction": {
"source": "CARD_PRESENT",
"transit": {
"aggregatedFare": {
"type": "FARE",
"aggregationStartDate": "2020-05-05",
"transportationMode": "TRAIN"
}
}
}
}
Si la demande a abouti, soumettez la demande Capture (Collecter) avec les détails suivants :
- l'identifiant de la commande de la transaction Authorization (Autorisation) réussie dans le champ
order.id - l'identifiant de transaction unique dans la commande pour la transaction Capture (Collecter) dans le champ
transaction.id - le montant autorisé avec succès dans le champ
transaction.amount - la devise de la commande, identique à celle de la transaction Authorization (Autorisation), dans le champ
transaction.currency
Vous trouverez ci-dessous un exemple REST de demande Capture (Collecter) pour les frais de transit cumulés.
| URL | https://na-gateway.mastercard.com/api/rest/version/66/merchant/CYG_S2I_MER2/order/{{order_id}}/transaction/{{transaction_id}} |
| Méthode HTTP | PUT |
{
"apiOperation": "CAPTURE",
"transaction": {
"amount": "15.00",
"currency": "AUD"
}
}
Le payeur peut à nouveau utiliser la carte au cours de la période de transport suivante. Si la demande Authorization (Autorisation) échoue, passez au scénario Risque du premier trajet.
Risque du premier trajet
Carte Mastercard ou American Express
La passerelle ne prend pas encore en charge le risque du premier trajet dans le cadre de Mastercard.
Carte Visa
À la fin de la période de transport, lorsque la demande Authorization (Autorisation) est refusée mais qu'elle peut être collectée en vertu des règles Visa, soumettez une demande Capture (Collecter) avec les détails suivants :
- un identifiant de la commande dans le champ order.id : il doit s'agir d'un nouveau champ order.id ; vous ne pouvez pas utiliser le même champ order.id que celui utilisé pour la demande Authorize (Autoriser) refusée
- un identifiant de transaction unique dans la commande pour la transaction Capture (Collecter) dans le champ transaction.id
- le montant du total des frais cumulés, comme indiqué dans la demande Authorization (Autorisation) ayant échoué dans le champ ordre.montant
- la devise de la commande telle qu'indiquée dans la demande Authorization (Autorisation) ayant échoué dans le champ order.currency
- le champ transaction.transit.aggregatedFare.type=FARE
- le champ transaction.transit.aggregatedFare.aggregationStartDate avec la date de la première utilisation
- le champ transaction.transit.aggregatedFare.transportationMode avec une valeur d'énumération valide qui reflète le mode de transport utilisé par le payeur pour le premier trajet
- le champ sourceOfFunds.provided.card.emvRequest avec des données EMV valides de la dernière utilisation au cours de la période de transport
- le champ sourceOfFunds.provided.card.sequenceNumber
- le champ transaction.source=CARD_PRESENT
- le champ posTerminal.attended=UNATTENDED
- le champ posTerminal.location = MERCHANT_TERMINAL_ON_PREMISES
- le champ posTerminal.cardholderActivated=SELF_SERVICE_TERMINAL
- le champ posTerminal.inputCapability=CONTACTLESS_CHIP
- le champ posTerminal.panEntryMode=CONTACTLESS
- le champ posTerminal.pinEntryCapability=PIN_NOT_SUPPORTED
- la valeur numérique à 15 chiffres, retournée dans le champ authorizationResponse.transactionIdentifier de la réponse Authorization (Autorisation) ayant échoué, dans le champ authorizationResponse.transactionIdentifier
- la valeur à 1 lettre, retournée dans le champ authorizationResponse.returnAci de la réponse Authorization (Autorisation) ayant échoué, dans le champ authorizationResponse.returnAci
- le champ transaction.authorizationCode=VFT000 : il s'agit du code d'autorisation défini par Visa dans ce but particulier
Vous trouverez ci-dessous un exemple REST de demande Sandalone Capture (Collecte autonome) pour les frais de transit cumulés.
| URL | https://na-gateway.mastercard.com/api/rest/version/66/merchant/CYG_S2I_MER2/order/{{order_id}}/transaction/{{transaction_id}} |
| Méthode HTTP | PUT |
{
"apiOperation": "CAPTURE",
"posTerminal": {
"address": {
"country": "AUS",
"postcodeZip": "4000"
},
"attended": "UNATTENDED",
"cardPresenceCapability": "CARD_PRESENT",
"cardholderActivated": "SELF_SERVICE_TERMINAL",
"inputCapability": "CONTACTLESS_CHIP",
"lane": "teapost",
"location": "MERCHANT_TERMINAL_ON_PREMISES",
"panEntryMode": "CONTACTLESS",
"pinEntryCapability": "PIN_NOT_SUPPORTED"
},
"sourceOfFunds": {
"provided": {
"card": {
"emvRequest": {
"5F2A": "036",
"5F34": "099",
"82": "0000",
"84": "010101010101",
"95": "0000000000",
"9A": "161021",
"9B": "0101",
"9C": "00",
"9F02": "000000010000",
"9F03": "000000000000",
"9F10": "06011103A000000A0100000000000BB0ABAD",
"9F1A": "036",
"9F1E": "0123ABCD",
"9F26": "D1F722D47FCA8273",
"9F27": "40",
"9F33": "E0B8C8",
"9F34": "1E0300",
"9F35": "12",
"9F36": "0002",
"9F37": "2A4E1690",
"9F6E": "0101"
},
"expiry": {
"month": "05",
"year": "25"
},
"track2": "400555xxxxxx0019=391220116006711"
}
},
"type": "CARD"
},
"transaction": {
"amount": "8.00",
"currency": "AUD",
"source": "CARD_PRESENT",
"authorizationCode": "VFT000",
"transit": {
"aggregatedFare": {
"type": "FARE",
"aggregationStartDate": "2022-05-05",
"transportationMode": "TRAIN"
}
}
},
"authorizationResponse": {
"transactionIdentifier": "140929101914398",
"returnAci": "Y"
}
}
La transaction Capture (Collecter) d'une demande Authorization (Autorisation) ayant échoué est autorisé sous les règles Visa si :
- l'émetteur a refusé la première demande Authorization (Autorisation) pour cette carte,
- l'émetteur a refusé la première demande Authorization (Autorisation) depuis la précédente demande Authorization (Autorisation) réussie pour des frais de transit cumulés, et
- le montant de la transaction est inférieur ou égal au seuil de rétrofacturation de votre pays.
Après avoir soumis la demande Capture (Collecter), la carte sera toujours sur la liste des refus. Vous pouvez utiliser le recouvrement de la dette initié par le commerçant pour déterminer si la carte est de nouveau en règle et doit donc être retirée de la liste des refus. Soumettez la demande Authorization (Autorisation) sur une nouvelle commande avec les détails suivants :
- le champ order.id : il doit s'agir d'un nouvel order.id
- le champ transaction.id
- le champ order.amount : il doit s'agir du même montant que celui de la transaction Standalone Capture (Collecte autonome)
- la devise dans le champ order.currency
- le champ transaction.transit.aggregatedFare.type=DEBT_RECOVERY_MERCHANT_INITIATED
- le champ transaction.transit.aggregatedFare.transportationMode (obligatoire) avec une valeur d'énumération valide
- le champ transaction.source=MERCHANT
- le champ transaction.transit.aggregatedFare.aggregationStartDate (obligatoire) avec la date de la première utilisation
- la valeur numérique à 15 chiffres, retournée dans le champ authorizationResponse.transactionIdentifier et transaction.acquirer.customData de la réponse Authorization (Autorisation) ayant échoué, en utilisant la syntaxe suivante : {"VisaTransitFailedAuthTransactionIdentifier":"<value>"}
- les détails du paiement, notamment le numéro de carte, la date d'expiration, etc.
Si la demande Authorization (Autorisation) a abouti, vous devez retirer la carte de la liste des refus dans l'heure et soumettre immédiatement une transaction Void Authorization (Annuler l'autorisation).
Void Authorization (Annuler l'autorisation)
Vous devez ensuite soumettre une demande WS API VOID sur une même commande que celle de la transaction Authorization (Autorisation) réussie avec :
- le champ order.id : il doit s'agit du champ order.id de la transaction Authorization (Autorisation) réussie
- le champ transaction.id : il doit s'agir d'un nouvel ID de transaction sur la commande
- le champ transaction.targetTransactionId : il doit s'agir du champ transaction.id de la transaction Authorization (Autorisation) réussie
Vous pouvez répéter la demande Authorization (Autorisation) jusqu'à ce que le nombre de tentatives autorisées soit atteint ou à la fréquence des demandes de recouvrement de la dette initié par le commerçant. Pour plus d'informations sur le recouvrement de la dette initié par le commerçant, voir le scénario Recouvrement de la dette ci-dessous. L'émetteur est responsable de la demande Standalone Capture (Collecte autonome). Cela signifie qu'une transaction Capture (Collecter) réussie n'indique pas que le compte du payeur est en règle et que la carte peut être retirée de la liste des refus.
Recouvrement de la dette initié par le commerçant
Les systèmes vous permettent de tenter de recouvrer des dettes impayées pour les frais de transit sans impliquer le payeur. Après le recouvrement de la dette, la carte sera de nouveau acceptée pour les transports dès que le compte du payeur sera de nouveau en règle.
Pour soumettre des transactions de recouvrement de la dette, fournissez les détails de paiement qu'utilise un payeur.
- Paiement EMV sans contact : fournissez les détails FPAN.
- Paiement mobile sans contact :
- Pour Mastercard : fournissez les détails FPAN. la passerelle fournira les détails du FPAN dans la réponse de transaction à la transaction d'origine.
- Pour la carte Visa : fournissez les détails DPAN. Assurez-vous de stocker ces détails car la passerelle ne vous permet pas de les récupérer.
Carte Mastercard ou American Express
Si la demande Authorization (Autorisation) que vous avez soumise lors du premier trajet au cours de la période de transport échoue, vous pouvez alors tenter de recouvrer le total des frais pour ce trajet conformément aux règles applicables du système Mastercard. Soumettez une demande Authorization (Autorisation) avec les détails suivants :
- un identifiant de la commande dans le champ
order.id: il doit s'agir d'un nouveau champ order.id ; il ne peut pas s'agir du même champ order.id que celui utilisé pour la demande VERIFY (Vérifier), la demande AUTHORIZE (Autoriser) refusée ou la demande CAPTURE (Collecter) - un identifiant unique dans la commande pour la transaction
Authorization(Autorisation) dans le champtransaction.id transaction.transit.aggregatedFare.type=DEBT_RECOVERY_MERCHANT_INITIATED- le champ
transaction.transit.aggregatedFare.transportationModeavec une valeur d'énumération valide qui reflète le mode de transport que le payeur utilise pour le premier trajet - le champ
transaction.transit.aggregatedFare.aggregationStartDateavec une date de début valide pour le trajet transaction.source=MERCHANT- les détails du paiement, notamment le FPAN et l'expiration du FPAN
Vous trouverez ci-dessous un exemple REST de demande Authorization (Autorisation) pour les frais de transit cumulés pour le recouvrement de la dette.
| URL | https://na-gateway.mastercard.com/api/rest/version/66/merchant/CYG_S2I_MER2/order/{{order_id}}/transaction/{{transaction_id}} |
| Méthode HTTP | PUT |
{
"apiOperation": "AUTHORIZE",
"order": {
"amount": "15.00",
"currency": "AUD"
},
"sourceOfFunds": {
"provided": {
"card": {
"expiry": {
"month": "12",
"year": "39"
},
"number": "512345xxxxxx1234",
"sequenceNumber": "099"
}
},
"type": "CARD"
},
"transaction": {
"source": "MERCHANT",
"transit": {
"aggregatedFare": {
"type": "DEBT_RECOVERY_MERCHANT_INITIATED",
"aggregationStartDate": "2020-05-05",
"transportationMode": "TRAIN"
}
}
}
}
Si la demande a abouti, soumettez la demande Capture (Collecter) avec les détails suivants :
- l'identifiant de commande de la transaction Authorization (Autorisation) réussie dans le champ order.id
- un identifiant de transaction unique dans la commande pour la transaction Capture (Collecter) dans le champ transaction.id
- le montant autorisé avec succès dans le champ transaction.amount
- la devise de la commande, identique à celle de la transaction Authorization (Autorisation), dans le champ transaction.currency
Vous trouverez ci-dessous un exemple REST de demande Capture (Collecter) pour les frais de transit cumulés pour le recouvrement de la dette.
| URL | https://na-gateway.mastercard.com/api/rest/version/66/merchant/CYG_S2I_MER2/order/{{order_id}}/transaction/{{transaction_id}} |
| Méthode HTTP | PUT |
{
"apiOperation": "CAPTURE",
"transaction": {
"amount": "15.00",
"currency": "AUD"
}
}
Après le recouvrement de la dette, retirez la carte de la liste des refus. La transaction Authorization (Autorisation) pour le recouvrement de la dette ne sera réussie que si les payeurs disposent de fonds suffisants sur leur compte. Les émetteurs n'assument pas la responsabilité des opérations de recouvrement de la dette. Si la demande Authorization (Autorisation) échoue, vous pouvez retenter le recouvrement de la dette conformément aux règles applicables du système Mastercard. Mastercard définit le montant autorisé pour l'opération de recouvrement de la dette et la fréquence des tentatives de recouvrement de la dette. Le montant autorisé doit être inférieur ou égal au plafond des transactions sans contact de transit cumulées que Mastercard définit. Vous ne devez pas tenter de recouvrer une dette si vous disposez d'informations suffisantes pour déterminer que la demande Authorization (Autorisation) pour le premier trajet de la période de transport a été refusée en raison d'une carte perdue ou volée, c'est-à-dire un refus ferme. Vous ne pouvez pas récupérer les fonds si la carte est perdue ou volée, si elle est refusée ou si toutes les tentatives autorisées de recouvrement de la dette ont échoué.
Carte Visa
Si vous n'avez pas soumis la demande Standalone Capture (Collecte autonome), vous pouvez tenter de recouvrer les frais conformément aux règles applicables du système Visa. Pour plus d'informations sur la première transaction refusée sur la carte Visa sans contact jusqu'à une limite de responsabilité partagée définie pour les transactions de mobilité et de transport, voir le scénario Risque du premier trajet.
Soumettez la demande Authorization (Autorisation) avec les détails suivants :
- un identifiant de la commande dans le champ order.id : il doit s'agir d'un nouveau champ order.id ; il ne peut pas s'agir du même champ order.id que celui utilisé pour la demande VERIFY (Vérifier), la demande AUTHORIZE (Autoriser) refusée ou la demande CAPTURE (Collecter)
- un identifiant unique dans la commande pour cette transaction Authorization (Autorisation) dans le champ
transaction.id transaction.source=MERCHANTtransaction.transit.aggregatedFare.type=DEBT_RECOVERY_MERCHANT_INITIATED- le champ
transaction.transit.aggregatedFare.transportationModeavec une valeur d'énumération valide qui reflète le mode de transport que le payeur utilise pour le premier trajet - le champ
transaction.transit.aggregatedFare.aggregationStartDateavec une date de début valide pour le trajet - la valeur numérique à 15 chiffres, retournée dans les champs
authorizationResponse.transactionIdentifier and the transaction.acquirer.customDatade la réponse Authorization (Autorisation) ayant échoué, en utilisant la syntaxe suivante : {"VisaTransitFailedAuthTransactionIdentifier":"<value>"} - les détails du paiement, notamment le FPAN et l'expiration du FPAN lorsque la transaction d'origine était un paiement EMV sans contact, ou le DPAN et l'expiration du DPAN lorsque la transaction d'origine était un paiement mobile sans contact.
Vous trouverez ci-dessous un exemple REST de demande Authorization (Autorisation) pour les frais de transit cumulés pour le recouvrement de la dette.
| URL | https://na-gateway.mastercard.com/api/rest/version/66/merchant/CYG_S2I_MER2/order/{{order_id}}/transaction/{{transaction_id}} |
| Méthode HTTP | PUT |
{
"apiOperation": "AUTHORIZE",
"order": {
"amount": "15.00",
"currency": "AUD"
},
"sourceOfFunds": {
"provided": {
"card": {
"expiry": {
"month": "12",
"year": "39"
},
"number": "400555xxxxxx0019",
"sequenceNumber": "099"
}
},
"type": "CARD"
},
"transaction": {
"source": "MERCHANT",
"transit": {
"aggregatedFare": {
"type": "DEBT_RECOVERY_MERCHANT_INITIATED",
"aggregationStartDate": "2020-05-05",
"transportationMode": "TRAIN"
}
}
}
}
Si la demande a abouti, soumettez la demande Capture (Collecter) avec les détails suivants :
- l'identifiant de commande de la transaction Authorization (Autorisation) réussie dans le champ
order.id - un identifiant de transaction unique dans la commande pour la transaction Capture (Collecter) dans le champ
transaction.id - le montant autorisé avec succès dans le champ
transaction.amount - la devise de la commande, identique à celle de la transaction Authorization (Autorisation), dans le champ
transaction.currency
Vous trouverez ci-dessous un exemple REST de demande Capture (Collecter) pour les frais de transit cumulés pour le recouvrement de la dette.
| URL | https://na-gateway.mastercard.com/api/rest/version/66/merchant/CYG_S2I_MER2/order/{{order_id}}/transaction/{{transaction_id}} |
| Méthode HTTP | PUT |
{
"apiOperation": "CAPTURE",
"transaction": {
"amount": "15.00",
"currency": "AUD"
}
}
Après le recouvrement de la dette, conformément aux règles Visa, vous devez retirer la carte de la liste des refus dans l'heure qui suit l'approbation de la demande Authorization (Autorisation). Si la demande Authorization (Autorisation) échoue, vous pouvez retenter le recouvrement de la dette conformément aux règles applicables du système Visa. Visa définit le nombre autorisé de tentatives de recouvrement de la dette.
Recouvrement de la dette initié par le payeur
Ce scénario s'applique à Mastercard, Visa et American Express. Pour les paiements de recouvrement de la dette initié par le payeur, vous ne devez soumettre aucun champ dans le groupe de paramètres transaction.transit. La transaction de recouvrement de la dette initié par le payeur sera traitée comme une transaction normale dans laquelle le payeur effectue un achat auprès du commerçant.
Recouvrement de la dette initié par l'utilisation
Ce scénario s'applique à Mastercard, Visa et American Express.
Pour les paiements de recouvrement de la dette initié par l'utilisation, vous ne devez soumettre aucun des champs du groupe de paramètres transaction.transit. La transaction de recouvrement de la dette initié par l'utilisation sera traitée comme une transaction normale dans laquelle le payeur effectue un achat auprès du commerçant.
Test de votre intégration
Pour plus d'informations sur le test de votre intégration, contactez votre représentant de compte.