mastercard mdes customer service net45 tutorial

.NET 4.5: Comment s'intégrer au service client MasterCard MDES?

Table des matières

• Aperçu
• Condition préalable
• Étape 1: Générez une bibliothèque client API .NET 4.5
• Étape 2: Ouvrez et construisez la solution générée
• Étape 3: Ajoutez un projet d'application de console à la solution
• Étape 4: étendre l'apiclient pour utiliser JSON
• Étape 5: Envoyez des demandes à l'API de recherche MDES

Aperçu

MasterCard fournit des bibliothèques clients pour s'intégrer à ses services, mais les packages .NET ne prennent pas en charge .NET Framework 4.5, dont le support s'est terminé en 2016:

• Le signatrice C # OAuth1 prend en charge .NET Standard 1.3 (.NET Framework 4.6+)
• MasterCard Core et MasterCard MDES Service client SDKS Prise en charge .NET Framework 4.6.1+

Ce didacticiel explique comment consommer le service client MasterCard MDES à partir d'une application .NET 4.5 en générant une bibliothèque client API avec un générateur OpenAPI et en signant des demandes HTTP à l'aide d'une version .NET 4.5 de la Signer LIB OAuth1.

Condition préalable

1. Lire la documentation du service client MDES
2. Téléchargez la spécification du service client MDES OpenAPI
3. Configurez un projet dans le portail des développeurs MasterCard, ajoutez-y l'API du service client MDES:

4. Découvrez et créez la version .NET 4.5 de la bibliothèque de signataires OAuth1

Étape 1: Générez une bibliothèque client API .NET 4.5

Une bibliothèque client .NET 4.5 pour le service client MDES peut être générée à l'aide de la commande suivante:

java -jar openapi-generator-cli.jar generate -i mdes-customer-service-2.0.4.yaml -g csharp -c config.json -o mdes-customer-service-net45-tutorial

config.json:

{ 
    "targetFramework" : " v4.5 " ,
    "packageName" : " YourApp.MdesCustomerClient " 
}

Voir aussi: Générateur OpenAPI (exécutable)

Étape 2: Ouvrez et construisez la solution générée

1. Accédez au dossier MDES-Customer-Service-Net45-tutorial / SRC
2. Correction des fichiers du projet (.csproj) en supprimant Condition="Exists('....packages')" dans les éléments HintPath , exemple:

< Reference Include = " RestSharp " >
    < HintPath >....packagesRestSharp.105.1.0libnet45RestSharp.dll</ HintPath >
</ Reference >

3. Ouvrez votreapp.mDescustomerClient.sln
4. Cliquez sur Build> Rebuild Solution

Étape 3: Ajoutez un projet d'application de console à la solution

1. Cliquez sur Fichier> Nouveau> Projet ...
2. Choisissez l'application Console (.NET Framework) et configurez le projet de la manière suivante:

3. Cliquez avec le bouton droit sur les références et ajoutez les dépendances suivantes au projet YourApp.Console :
   • YourApp.MdesCustomerClient
   • Mastercard.Developer.OAuth1Signer.Core.dll (.net 4.5 version)
   • Mastercard.Developer.OAuth1Signer.RestSharp.dll (version .net 4.5)
   • RestSharp.dll

Étape 4: étendre ApiClient pour utiliser JSON

Par défaut, le service client MDES accepte et renvoie les charges utiles XML lorsque notre code généré s'attend à ce que JSON soit utilisé.

Pour indiquer le service que nous parlons JSON, créez une nouvelle classe dans le projet YourApp.MdesCustomerClient définissant la méthode partielle InterceptRequest la manière suivante:

 using RestSharp ;

namespace YourApp . MdesCustomerClient . Client
{
    /// <summary>
    /// Extends the generated ApiClient class.
    /// </summary>
    public partial class ApiClient
    {
        /// <summary>
        /// Adds "Format=JSON" to the RestSharp request so that the service accepts and returns JSON instead of XML.
        /// </summary>
        partial void InterceptRequest ( IRestRequest request ) => request . AddQueryParameter ( "Format" , "JSON" ) ;
    }
} 

Étape 5: Envoyez des demandes à l'API de recherche MDES

1. Mettre à jour le programme.cs avec le code suivant:

 class Program
{
    static void Main ( string [ ] args )
    {
        // The request was aborted: Could not create SSL/TLS secure channel
        ServicePointManager . Expect100Continue = true ;
        ServicePointManager . SecurityProtocol = SecurityProtocolType . Tls12 ;

        var consumerKey = "<insert consumer key>" ;
        var signingKey = SecurityUtils . LoadPrivateKey ( "<insert PKCS#12 key file path>" , "<insert key alias>" , "<insert key password>" ) ; // Pass X509KeyStoragFlags here
        var config = Configuration . Default ;
        config . BasePath = "https://sandbox.api.mastercard.com/mdes/csapi/v2" ;
        config . ApiClient . RestClient . Authenticator = new RestSharpOAuth1Authenticator ( consumerKey , signingKey , new Uri ( config . BasePath ) ) ;
        var searchApi = new SearchApi ( config ) ;
        var auditInfo = new AuditInfo ( "A1435477" , "John Smith" , "Any Bank" , "5555551234" ) ;
        var tokenUniqueReference = "DWSPMC00000000010906a349d9ca4eb1a4d53e3c90a11d9c" ;
        var searchRequest = new SearchRequest ( null , tokenUniqueReference , null , null , null , null , null , null , auditInfo ) ;
        var response = searchApi . SearchPost ( new SearchRequestSchema ( searchRequest ) ) ;
        System . Console . WriteLine ( response . SearchResponse . Accounts . Account [ 0 ] . Tokens . Token [ 0 ] ) ;
        System . Console . ReadLine ( ) ;
    }
}

2. Utilisez votre propre consumerKey , pkcs12KeyFilePath , signingKeyAlias , signingKeyAlias et keyStorageFlags .
3. Cliquez sur Débogue
4. Vous devriez obtenir un résultat similaire à celui-ci: