mastercard mdes customer service net45 tutorial

.NET 4.5: Wie integrieren Sie den MasterCard MDES -Kundendienst?

Inhaltsverzeichnis

• Überblick
• Voraussetzungen
• Schritt 1: Generieren Sie eine .NET 4.5 -API -Client -Bibliothek
• Schritt 2: Öffnen und erstellen Sie die erzeugte Lösung
• Schritt 3: Fügen Sie der Lösung ein Konsolen -App -Projekt hinzu
• Schritt 4: Erweitern Sie apiclient, um JSON zu verwenden
• Schritt 5: Anfragen an die MDES -Such -API senden

Überblick

MasterCard bietet Clientbibliotheken für die Integration in seine Dienste. Die .NET -Pakete unterstützen jedoch nicht .NET Framework 4.5, deren Unterstützung 2016 endete:

• Der C# OAuth1 Signer LIB unterstützt .NET Standard 1.3 (.NET Framework 4.6+).
• MasterCard Core und MasterCard MDES Kundendienst SDKs Support .NET Framework 4.6.1+

In diesem Tutorial wird erläutert, wie der MasterCard -MDES -Kundendienst von einer .NET 4.5 -App konsumiert wird, indem eine API -Client -Bibliothek mit OpenAPI -Generator generiert und HTTP -Anforderungen mit einer .NET 4.5 -Version der OAUTH1 Signer LIB unterzeichnet wird.

Voraussetzungen

1. Lesen Sie die MDES -Kundendienstdokumentation
2. Laden Sie die MDES Customer Service OpenAPI -Spezifikation herunter
3. Richten Sie ein Projekt im MasterCard Developers -Portal ein und fügen Sie die MDES -Kundendienst -API hinzu:

4. Checkout und erstellen Sie die .NET 4.5 -Version der OAuth1 -Signer -Bibliothek

Schritt 1: Generieren Sie eine .NET 4.5 -API -Client -Bibliothek

Eine .NET 4.5 -Client -Bibliothek für den MDES -Kundendienst kann mit dem folgenden Befehl generiert werden:

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 " 
}

Siehe auch: OpenAPI -Generator (ausführbar)

Schritt 2: Öffnen und erstellen Sie die erzeugte Lösung

1. Navigieren Sie zum MDES-Customer-Service-NET45-Tutorial/SRC- Ordner
2. Beheben Sie die Projektdateien (.csproj) durch Löschen von Condition="Exists('....packages')" in HintPath -Elementen, Beispiel:

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

3. Öffnen Sie Ihren Anapp.MdescustomerClient.sln
4. Klicken Sie auf Build> Lösung wieder aufbauen

Schritt 3: Fügen Sie der Lösung ein Konsolen -App -Projekt hinzu

1. Klicken Sie auf Datei> Neu> Projekt ...
2. Wählen Sie die Konsolen -App (.NET Framework) und konfigurieren Sie das Projekt auf folgende Weise:

3. Klicken Sie mit der rechten Maustaste auf die Referenzen und fügen Sie das Projekt für YourApp.Console hinzu:
   • YourApp.MdesCustomerClient
   • Mastercard.Developer.OAuth1Signer.Core.dll (.NET 4.5 -Version)
   • Mastercard.Developer.OAuth1Signer.RestSharp.dll (.NET 4.5 -Version)
   • RestSharp.dll

Schritt 4: Erweitern Sie ApiClient , um JSON zu verwenden

Standardmäßig akzeptiert und gibt der MDES -Kundendienst XML -Nutzlasten zurück, wenn unser generierter Code erwartet, dass JSON verwendet wird.

Um den Dienst anzugeben, den wir JSON sprechen, erstellen Sie eine neue Klasse im Projekt YourApp.MdesCustomerClient , das die teilweise Methode InterceptRequest die folgende Weise definiert:

 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" ) ;
    }
} 

Schritt 5: Anfragen an die MDES -Such -API senden

1. Aktualisieren Sie das Programm.cs mit dem folgenden Code:

 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. Verwenden Sie Ihren eigenen consumerKey , pkcs12KeyFilePath , signingKeyAlias , signingKeyAlias und keyStorageFlags .
3. Klicken Sie auf Debuggen
4. Sie sollten ein ähnliches Ergebnis wie dieses erhalten: