Spécificités régionales

Intégrer Terminal au Canada

Stripe prend en charge les paiements Visa, Mastercard, American Express, Discover et Interac au Canada. Toutes les transactions doivent être libellées en dollars canadiens (CAD). Pour accepter un paiement Terminal au Canada, le compte de votre plateforme ou le compte connecté doit être établi au Canada.

Utiliser les emplacements

Créez des emplacements pour votre entreprise avec des adresses en/à/au(x) Canada et associez-y vos lecteurs. Ainsi, ces derniers téléchargeront automatiquement la configuration nécessaire pour traiter correctement les paiements en/à/au(x) Canada.

Pour être valide, l’adresse d’un emplacement en/à/au(x) Canada doit contenir les propriétés line1, city, state, postal_code, and country.

curl https://api.stripe.com/v1/terminal/locations \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "display_name"="HQ" \
  -d "address[line1]"="3040 Bur Oak Ave" \
  -d "address[city]"="Markham" \
  -d "address[state]"="ON" \
  -d "address[country]"="CA" \
  -d "address[postal_code]"="L6B 0R1" \

Version logicielle du lecteur

Les lecteurs Verifone P400 utilisés au Canada doivent utiliser la version 3.0.1.15 ou une version ultérieure du logiciel. Pour plus d’informations, consultez les mises à jour du logiciel du lecteur Verifone P400.

De la même manière, les lecteurs BBPOS WisePad 3 doivent utiliser la version du logicielle 4.01.00.41_Prod_NA_off_v23_480001 ou une version ultérieure. Pour en savoir plus, consultez les mises à jour logicielles de BBPOS WisePad 3.

Traduction

En raison de règlementations linguistiques les services, (y compris les services pour point de vente) doivent être fournis en French, sauf lorsque le titulaire et l’émetteur de la carte bancaire ont convenu d’utiliser l’anglais. Terminal est conçu pour vous permettre de vous conformer à ces exigences si elles concernent votre entreprise.

Langue par défaut du lecteur

L’interface du Verifone P400 affiche du texte en French et en anglais si l’adresse à laquelle il est enregistré est située en/à/au(x) Canada.

Le lecteur BBPOS WisePOS E et le lecteur Stripe S700 offrent la possibilité de changer de langue dans le panneau Paramètres. Balayez l’écran vers la droite pour accéder au panneau Paramètres, puis sélectionnez votre langue.

Le lecteur BBPOS WisePad 3 prend en charge le changement de langue directement dans l’interface du lecteur. Après avoir attribué un emplacement au lecteur avec une adresse en/à/au(x) Canada, le lecteur installe le paquet linguistique correspondant à votre région, si ce n’est pas déjà fait. Pour afficher les langues disponibles et sélectionner une langue, cliquez sur le bouton Alimentation/Paramètres et faites défiler vers le bas à l’aide des touches fléchées jusqu’à atteindre le menu du choix de la langue. Mettez en surbrillance la langue souhaitée et appuyez sur la touche verte Entrée.

Langue de la transaction

Une fois la carte bancaire présentée par son titulaire, le lecteur en détermine la langue principale. Chaque écran est ensuite affiché dans la langue du titulaire de carte.

Autres traductions

Si vous êtes tenus d’offrir vos services en ou souhaitez traduire du texte en French et en anglais, veillez à ce que les écrans et reçus de vos lecteurs personnalisés affichent les traductions appropriées.

Paiements Interac

Interac is the interbank network that handles routing of debit payments in Canada. Consumer debit cards in Canada are branded with an Interac logo and might also be co-branded with another payment network’s logo. Even if the card is co-branded, however, all Interac debit transactions must be routed through Interac. To maximize card acceptance, you should build Interac support into your integration.

Créer un PaymentIntent

Pour accepter les transactions Interac, vous devez créer vos paiements à l’aide du type de moyen de paiement interac_present. Si vous acceptez les paiements Visa, Mastercard et American Express, incluez également le type de moyen de paiement card_present.

Côté client

Create a PaymentIntent from your client using one of the following options:

Côté serveur

The JavaScript SDK and the server-driven integration require you to create the PaymentIntent on your server. For the other client SDKs, you can create the PaymentIntent on your server if the information required to start a payment isn’t readily available in your app.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=999 \
  -d currency=cad \
  -d "payment_method_types[]"=card_present \
  -d "payment_method_types[]"=interac_present \
  -d capture_method=manual

Encaisser et traiter un paiement

Une fois le paiement traité, le lecteur décide de l’acheminer ou non via Interac, selon le profil de la carte présentée.

Lorsque la carte bancaire Interac est co-marquée, le champ payment_method_details.interac_present.brand du paiement renvoyé par un PaymentIntent indique la co-marque. Le champ indiquant le type de payment_method d’une transaction Interac est toujours interac_present.

Il existe d’autres exigences Interac, que Stripe gère pour vous de manière automatique, sans effort d’intégration supplémentaire de votre part :

• Avant qu’une carte ne soit présentée, les instructions sur l’écran s’affichent dans la langue par défaut du lecteur. Une fois les informations de carte bancaire collectées, la localisation est définie à partir des préférences linguistiques spécifiées par la carte présentée.
• Le lecteur demande automatiquement la saisie du code PIN lorsqu’elle est requise.
• Les paiements Flash Interac (sans contact) sont limités à 250 CAD et ne dépassent généralement pas trois transactions consécutives. Pour les transactions supérieures à 100 CAD ou pour la quatrième transaction sans contact consécutive, le client doit insérer sa carte Interac et saisir son code PIN.

Capturer et rapprocher

Unlike Visa, Mastercard, and American Express transactions, Interac transactions are authorized and automatically captured in a single step. Make sure that your application doesn’t continue to capture the PaymentIntent. If you attempt to capture an interac_present payment, the Stripe API returns an error. Make sure that you prevent unintended and duplicate payments in your integration; if failures or declines occur while processing Interac, you can attempt to re-use the same PaymentIntent from the original transaction to safeguard against double-charging.

Rembourser un paiement Interac

Les remboursements de transactions Interac au Canada s’effectuent obligatoirement par TPE. La création de remboursements dans l’API ou le Dashboard est impossible pour ces paiements. Dans ce flux, le lecteur invite le titulaire de la carte à présenter la carte bancaire utilisée lors du paiement initial. Une fois les informations de carte lues, votre application traite le remboursement. Comme pour les remboursements en ligne, vous pouvez effectuer des remboursements partiels en transmettant un montant inférieur à la valeur de la transaction.

La devise et la carte bancaire utilisées pour le traitement du remboursement doivent correspondre à celles du paiement initial, sans quoi la demande échoue avec un message d’erreur.

Lorsque cette méthode n’est pas disponible, vous pouvez proposer de rembourser le client à l’aide d’un autre moyen de paiement, par exemple en espèces ou crédit magasin.

curl https://api.stripe.com/v1/terminal/readers/tmr_xxx/refund_payment \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d payment_intent=pi_xxx \
  -d amount=2000

{
  "id": "tmr_xxx",
  "object": "terminal.reader",
  "action": {
    "type": "refund_payment",
    "refund_payment": {
      "payment_intent": "pi_xxx"
    },
    "status": "in_progress",
    "failure_code": null,
    "failure_message": null
  },
  …
}

curl https://api.stripe.com/v1/test_helpers/terminal/readers/tmr_xxx/present_payment_method \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d type=interac_present