- Directives d'intégration
- Fonctionnalités prises en charge (Modes de paiement)
- Paiements mobiles sans contact
Paiements mobiles sans contact
Les paiements mobiles sans contact désignent les transactions authentifiées à l'aide d'un appareil mobile (smartphone, tablette, smartwatch, par exemple) sur un terminal sans contact. Le terminal lit les données de la carte à partir d'une puce sans contact dans l'appareil mobile.
Une carte de crédit/débit ajoutée à un compte sur l'appareil mobile du payeur fait l'objet de la création de jeton et l'appareil se voit affecter un identifiant spécifique appelé DPAN (Device PAN). Le DPAN est converti en FPAN (Funding PAN) correspondant par le processeur de paiement.
Le FPAN est le numéro de compte principal (Primary Account Number [PAN]) de la carte du payeur. Il s'agit du numéro de carte réel enregistré par rapport au DPAN et utilisé pour traiter la transaction. Un FPAN peut être associé à plusieurs DPAN.
Un paiement mobile sans contact est initié par le terminal sans contact et envoyé à la passerelle en tant que transaction Capture (Collecter), Authorize (Autoriser), Pay (Payer) ou Refund (Rembourser). Par exemple, les transactions autorisées hors ligne par la puce figurant sur l'appareil mobile sont envoyées en tant que transaction Capture (Collecter) uniquement et les transactions nécessitant une autorisation de la part de l'émetteur utilisent une transaction Authorize (Autoriser) en ligne, suivie d'une transaction Capture (Collecter).
Conditions préalables
- Les transactions en présence de titulaire de carte doivent être activées par votre Your payment service provider et par votre acquéreur.
- Vous devez avoir un terminal activé pour les paiements sans contact.
Champs communs utilisés pour les transactions mobiles sans contact
Les champs d'API suivants concernent les paiements mobiles sans contact via la passerelle.
transaction.source=CARD_PRESENT
: si vous ne renseignez pas ce champ, la source de transaction par défaut configurée sur votre lien d'acquéreur par votre your payment service provider sera utilisée. [REST][NVP]sourceOfFunds.provided.card.emvRequest
: Fournissez les balises EMV telles que lues sur la puce et prises en charge par la passerelle. Voir Champs de la transaction EMV.
La balise 9F1C (identifiant du terminal) doit être renseignée dans ce champ.
Assurez-vous que les champs de terminal PDV suivants sont correctement définis, en fonction de la manière dont le terminal génère les données de carte pour la transaction. Si les données pour ces champs sont disponibles, vous devez toujours les indiquer. La passerelle transmettra les données à l'acquéreur, comme requis. Si l'acquéreur demande un champ et si celui-ci n'est pas présent, la transaction échouera.
posTerminal.address
posTerminal.attended
: Si vous ne renseignez pas ce champ, la passerelle utilise par défaut la valeurUNKNOWN_OR_UNSPECIFIED
posTerminal.authorizationMethod
posTerminal.cardHolderActivated
: Si vous ne renseignez pas ce champ, la passerelle utilise par défaut la valeurNOT_CARDHOLDER_ACTIVATED
posTerminal.inputCapability
: Ce champ est obligatoire pour les transactions EMV.posTerminal.location
: Ce champ est obligatoire pour les transactions EMV.posTerminal.panEntryMode
posTerminal.pinEntryCapability
posTerminal.onlineReasonCode
: Ce champ est obligatoire pour les transactions par puce et les transactions d'actions de secours par puce (notamment les annulations) pour toutes les transactions en ligne.posTerminal.serialNumber
order.gratuityAmount
: Renseignez ce champ si le paiement inclut un montant de pourboire.
[REST][NVP]order.cashbackAmount
: Renseignez ce champ si le paiement inclut un montant de remise.
[REST][NVP]order.cashAdvance
: Renseignez ce champ si le paiement inclut un montant d'avance en espèces.
[REST][NVP]
Référence de l'API POS Terminal (Terminal de point de vente) [REST][NVP]
Réponse de transaction
Si le mappage entre DPAN et FPAN a réussi, la réponse RETRIEVE_TRANSACTION pour un paiement mobile sans contact renvoie :
- Le FPAN avec un masque 6.4, lorsque disponible auprès de l'acquéreur, dans le champ
sourceOfFunds.provided.card.number
. Pour les commerçants en transit, un FPAN complet peut être renvoyé. Voir Paiements agrégés des titres de transport. - L'expiration du FPAN, lorsque disponible auprès de l'acquéreur, dans le champ
sourceOfFunds.provided.card.expiry
. - DPAN masqué dans le champ
sourceOfFunds.provided.card.deviceSpecificNumber
.
Si vous êtes configuré pour recevoir des PAN non masqués dans la réponse de la transaction, la passerelle retournera un DPAN et un FPAN non masqués (avec un masque 6.4 ou non masqué suivant la prise en charge de l'acquéreur).