CyberSource

Cybersource est une passerelle de paiement mondiale de Visa qui permet un traitement sécurisé des paiements sans carte. DEUNA s'intègre à Cybersource via l'API REST, prenant en charge les flux commerciaux standard et le traitement spécialisé de l'industrie du voyage avec des champs de données spécifiques aux compagnies aériennes.

Opérations prises en charge

• Autorisation
• Capture (complète et partielle)
• Achat (capture automatique)
• Annuler (Annuler)
• Remboursement (complet et partiel)
• Versements (uniquement pour MX)
• 3DS MPI
• Plusieurs captures et remboursements partiels peuvent être activés via la configuration dans l'administrateur

Méthodes de paiement prises en charge

• Visa
• Carte Master
• American Express
• Dîners

Pays et devises actifs

• États-Unis (USD) et MX (MXN)

Intégrer Cybersource#

1. Recherchez Cybersource dans Connexions dans l’administration.
   1. Connectez-vous à votre session d'administration DEUNA.
   2. Cliquez Connexions.
   3. Rechercher Cybersource et cliquez Se connecter.
2. Dans Connexions, le panneau de configuration Cybersource s'ouvrira. Entrez ce qui suit :
   1. Nom: saisissez un nom pour référencer cette configuration d'informations d'identification.
   2. Devise: la devise utilisée
   3. Clé privée: Entrez votre clé privée de l'API Cybersource.
   4. Clé publique: Entrez votre clé publique.
   5. Merchant ID: Entrez votre identifiant de marchand Cybersource.
   6. Configuration acquéreur(uniquement pour MX) : Le commerçant peut choisir le processeur à utiliser. Si aucun n’est spécifié, sélectionnez le Par défaut option.
   7. Opérations: Choisissez le type d'opération que vous souhaitez effectuer : Achat ou Autorisation
   8. Choisissez si vous souhaitez activer la capture partielle multiple de DEUNA, le remboursement partiel multiple et/ou la DEUNA 3DS.
   9. Cliquez Se connecter. Une fois terminé, vous recevez un message de confirmation. Vous pouvez désormais le consulter dans l'onglet Connexions actives.

Industrie du voyage

• DEUNA prend en charge le traitement pour le secteur du transport aérien et du voyage avec Cyberosurce, permettant la soumission de données spécifiques aux compagnies aériennes qui qualifient les transactions pour des taux d'interchange améliorés et la conformité aux exigences du réseau de cartes. _Ceci n'est disponible que sur le marché américain.
• Les champs des compagnies aériennes nécessitent un flux Auth + Capture
  • Soumission des champs de données de la compagnie aérienne (orderType": "AIRLINE_ORDER") n'est pris en charge que dans l'étape Capture d'un flux Autorisation + Capture.
  • Il s'agit d'une limitation de Cybersource, pas d'une limitation DEUNA. L'opération Achat (capture automatique) ne prend pas en charge les champs de données des compagnies aériennes.
  • Pour utiliser les données de la compagnie aérienne : configurez la connexion dans l'Admin avec Autorisation comme type d'opération.

Champs obligatoires – Commande aérienne

Exemple:

{
  "order": {
    "airlineInformation": {
      "bookingItems": [
        {
          "legs": [
            {
              "carrierCode": "AM",
              "destination": {
                "date": "26-03-26",
                "iataCode": "MEX",
                "time": "11:50"
              },
              "fareBasisCode": "Y",
              "flightNumber": "411",
              "origin": {
                "date": "26-03-26",
                "iataCode": "EWR",
                "time": "08:01"
              },
              "serviceClass": "V",
              "stopoverCode": "O"
            },
          ],
          "passenger": {
            "firstName": "***dido",
            "lastName": "***chez",
            "type": "ADT"
          },
          "pnr": "CSOIUN"
        }
      ]
    },
    "billingAddress": {
      "address1": "***************3626",
      "address2": "***** 100",
      "addressType": "other",
      "city": "Sacramento",
      "countryCode": "PE",
      "createdAt": "2024-01-24T17:04:18.341610378Z",
      "email": "******eira@deuna.com",
      "firstName": "Jean",
      "identityDocument": "*******5894",
      "lastName": "*mith",
      "phone": "********7761",
      "stateName": "LIM",
      "updatedAt": "2024-01-24T17:04:18.34161046Z",
      "zipcode": "95864"
    },
    "currency": "USD",
    "itemsTotalAmount": 200,
    },
    "orderId": "66cc4f9d-293c-41a7-af80-377360a26134",
    "subTotal": 200,
    "timezone": "America/Mexico_City",
    "totalAmount": 200,
    "webhookUrls": {
      "notifyOrder": "https://webhook.site/cadu"
    }
  },
  "orderType": "AIRLINE_ORDER"
}

Considérations particulières et limitations#

Traitement asynchrone et mises à jour de statut

• Contrairement aux processeurs synchrones, Cybersource ne renvoie pas de statut final définitif immédiatement après la soumission d'une transaction. Les transactions passeront par des statuts intermédiaires jusqu'à ce que le traitement final soit terminé.
• Cybersource exécute son traitement la nuit. Pendant la journée, les transactions resteront en Processing, Capturing ou Refunding status.
• Après le processus complet côté Cybersource, DEUNA met à jour la transaction vers son statut final. Les commerçants doivent s'appuyer sur le point de terminaison de l'état de la transaction de DEUNA pour obtenir l'état actuel d'une transaction.