Conversion dynamique de devises électronique

Introduction

Notre solution Conversion dynamique de devises électronique (eDCC) convertit le montant de votre transaction dans la devise du pays d'émission de la carte de vos clients.

En utilisant eDCC, vous et vos clients bénéficierez de :

• Transparence - Vos clients ont une vue en temps réel de leur montant de transaction dans la devise qu'ils connaissent, leur permettant de prendre une décision d'achat éclairée
• Conformité – Implémentez automatiquement les réglementations locales imposées par les réseaux de paiement et les gouvernements locaux
• Couverture - Suivez les détails de l'eDCC via notre API, Webhooks et Merchant Portal

Nous serons ravis de vous aider à commencer !

Intégration

Les propriétés suivantes activent l'eDCC pour votre commande dans une demande CreateHostedCheckout/CreatePayment pour les méthodes d'intégration Hosted Checkout Page/Server-to-server/Intégration mobile/client :

Selon la méthode d'intégration, des différences s'appliquent :

• Hosted Checkout Page
• Server-to-server / Intégration mobile/client

Hosted Checkout Page

Suivez ces étapes pour créer une demande pour cette commande :

1. Vos clients accèdent à votre page de paiement et finalisent la commande
2. Vous envoyez cette demande CreateHostedCheckout à notre plateforme, incluant la propriété dccenabled pour indiquer que vous souhaitez utiliser cette fonctionnalité. Notre plateforme activera alors automatiquement eDCC sur cette commande :

   {
      "order":{
         "amountOfMoney":{
            "currencyCode":"AUD",
            "amount":2980
         }
      },
      "cardPaymentMethodSpecificInput":{
         "currencyConversionSpecificInput":{
            "dccEnabled":true
         }
      }
   }

3. Vous redirigez les clients dans le navigateur vers le redirectUrl. Une fois que vos clients entrent leur numéro de carte sur la page de paiement, notre plateforme récupère automatiquement le taux de eDCC et affiche l'option de montant pour la devise locale de vos clients et votre devise locale
4. Vos clients sélectionnent leur devise souhaitée et confirment le paiement
5. Nous traitons la transaction et vous recevez le règlement dans votre devise locale

Server-to-server

Suivez ces étapes pour créer une demande pour cette commande :

1. Vos clients accèdent à votre page de paiement et saisissent leurs données de carte de crédit pour finaliser l'achat
2. Vous envoyez cette demande GetDccRateInquiry à notre plateforme avec les propriétés suivantes pour recevoir des informations sur l'eDCC. Vous pouvez fournir les détails de la carte du client en utilisant
   cardNumber
   token
   hostedTokenizationId
   encryptedCustomerInput
   
   cardNumber
   

   {
     "cardSource": {
       "card": {
         "paymentProductId": 1,
         "cardNumber": "4450896052107792"
       }
     },
     "transaction": {
       "amount": {
         "amount": 3000,
         "currencyCode": "EUR"
       }
     }
   }

   
   token
   

   {
      "cardSource":{
         "token":"b2076d9f-b2ce-4488-95aa-25ba8aa1c7ce"
      },
      "transaction":{
         "amount":{
            "amount":1300,
            "currencyCode":"AUD"
         }
      }
   }

   
   hostedTokenizationId

   {
      "cardSource":{
         "hostedTokenizationId":"d153e6ea6a024613ad6bfeff15210f6c"
      },
      "transaction":{
         "amount":{
            "amount":1300,
            "currencyCode":"AUD"
         }
      }
   }

   
   encryptedCustomerInput

   {
      "cardSource":{
         "encryptedCustomerInput":"b2076d9f-b2ce-4488-95aa-25ba8aa1c7ce"
      },
      "transaction":{
         "amount":{
            "amount":1300,
            "currencyCode":"AUD"
         }
      }
   }

3. Notre plateforme renvoie le montant de base dans votre devise dans les propriétés proposal.baseAmount.currencyCode / currency et la devise locale de vos clients dans les propriétés targetAmount.amount / currency. La propriété rate inclut des détails supplémentaires de l'eDCC (c'est-à-dire dccSessionId) concernant l'échange. Assurez-vous d'afficher à la fois le proposal.baseAmount, le targetAmount.amount et les consignes de divulgation en temps réel pour une transparence maximale à vos clients avant le paiement réel
4. Vos clients sélectionnent l'une des deux devises sur votre page de paiement
5. Vous envoyez cette demande CreatePayment à notre plateforme, incluant les propriétés acceptedByUser pour indiquer le choix de devise de vos clients et le dccSessionId que vous avez reçu à l'étape 2

   {
     "cardPaymentMethodSpecificInput": {
       "currencyConversion": {
         "acceptedByUser": true,
         "dccSessionId": "44b1ea32125b4cb5a99e15641859dc8d"
       },
       "card": {
         "cardNumber": "4450896052107792",
         "cvv": "123",
         "expiryDate": "1225",
         "cardholderName": "Wile E. Coyote"
       },
       "paymentProductId": 1,
       "skipAuthentication": true,
       "transactionChannel": "ECOMMERCE",
       "authorizationMode": "SALE",
       "returnUrl": "test"
     },
     "order": {
       "amountOfMoney": {
         "amount": 3000,
         "currencyCode": "AUD"
       },
       "customer": {
         "billingAddress": {
           "AdditionalInfo": "b",
           "city": "Paris",
           "countryCode": "BE",
           "houseNumber": "13",
           "state": "Utah",
           "street": "Desertroad",
           "zip": "84536"
         },
         "locale": "fr_FR",
         "merchantCustomerId": "1234",
         "personalInformation": {
           "dateOfBirth": "19490917",
           "gender": "male",
           "name": {
             "firstName": "Wile",
             "surname": "Coyote",
             "surnamePrefix": "E.",
             "title": "Mr."
           }
         }
       },
       "references": {
         "merchantReference": "{{TIMESTAMP}}"
       }
     }
   }

6. Nous traitons la transaction et vous recevez le règlement dans votre devise locale

Transactions

Capturer / Rembourser les transactions eDCC

Pour capturer/rembourser une transaction eDCC, envoyez une demande standard de capture/remboursement à notre plateforme.

Obtenir des retours sur les transactions eDCC

Utilisez nos Webhooks ou toute requête GET telle que définie dans notre référence API pour recevoir des informations détaillées sur les transactions eDCC dans la propriété currencyConversion.

Une réponse typique de webhook/GET contient les propriétés suivantes :

Vérifier les transactions traitées dans Merchant Portal

Vous pouvez consulter les détails DCC pour toute transaction via le Merchant Portal. Pour ce faire, suivez ces étapes :

1. Connectez-vous au Merchant Portal et consultez la transaction comme décrit dans notre guide Merchant Portal
2. Trouvez des informations détaillées sur le DCC dans la section "Historique", y compris
   Montant en devise client
   Taux de change
   Taux de majoration
   Fournisseur de change
   Source de change
   Date de cotation