mastercard mdes customer service net45 tutorial

.NET 4.5: Bagaimana cara berintegrasi dengan Layanan Pelanggan MasterCard MDES?

Daftar isi

• Ringkasan
• Prasyarat
• Langkah 1: Hasilkan Perpustakaan Klien .NET 4.5 API
• Langkah 2: Buka dan bangun solusi yang dihasilkan
• Langkah 3: Tambahkan proyek aplikasi konsol ke solusi
• Langkah 4: Perpanjang Apik untuk menggunakan JSON
• Langkah 5: Kirim permintaan ke API pencarian MDES

Ringkasan

MasterCard menyediakan perpustakaan klien untuk berintegrasi dengan layanannya, tetapi paket .net tidak mendukung .NET Framework 4.5, yang dukungannya berakhir pada 2016:

• Lib penandatangan C# OAuth1 mendukung .NET Standard 1.3 (.NET Framework 4.6+)
• MasterCard Core dan MasterCard MDES Layanan Pelanggan SDKS Dukungan .NET Framework 4.6.1+

Tutorial ini menjelaskan cara mengkonsumsi layanan pelanggan MasterCard MDES dari aplikasi .NET 4.5 dengan menghasilkan perpustakaan klien API dengan generator OpenAPI dan menandatangani permintaan HTTP menggunakan versi .NET 4.5 dari OAuth1 Signer Lib.

Prasyarat

1. Baca dokumentasi layanan pelanggan MDES
2. Unduh spesifikasi OpenAPI Layanan Pelanggan MDES
3. Siapkan proyek di Portal Pengembang MasterCard, tambahkan API Layanan Pelanggan MDES ke dalamnya:

4. Checkout dan bangun versi .net 4.5 dari pustaka penandatangan OAuth1

Langkah 1: Hasilkan Perpustakaan Klien .NET 4.5 API

Perpustakaan klien .NET 4.5 untuk layanan pelanggan MDES dapat dihasilkan menggunakan perintah berikut:

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

Lihat juga: OpenAPI Generator (dapat dieksekusi)

Langkah 2: Buka dan bangun solusi yang dihasilkan

1. Arahkan ke folder MDES-Customer-Service-Net45-Tutorial/SRC
2. Perbaiki file proyek (.csproj) dengan menghapus Condition="Exists('....packages')" dalam elemen HintPath , contoh:

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

3. Buka yourapp.mdescustomerclient.sln
4. Klik Build> Solusi Kembali

Langkah 3: Tambahkan proyek aplikasi konsol ke solusi

1. Klik File> Baru> Proyek ...
2. Pilih Aplikasi Konsol (.NET Framework) dan konfigurasikan proyek dengan cara berikut:

3. Klik kanan pada referensi dan tambahkan dependensi berikut ke proyek YourApp.Console :
   • YourApp.MdesCustomerClient
   • Mastercard.Developer.OAuth1Signer.Core.dll (.net 4.5 versi)
   • Mastercard.Developer.OAuth1Signer.RestSharp.dll (.net 4.5 versi)
   • RestSharp.dll

Langkah 4: Perpanjang ApiClient untuk menggunakan JSON

Secara default, layanan pelanggan MDES menerima dan mengembalikan muatan XML ketika kode yang dihasilkan kami mengharapkan JSON akan digunakan.

Untuk menunjukkan layanan yang kami ajak bicara JSON, buat kelas baru di proyek YourApp.MdesCustomerClient yang mendefinisikan metode parsial InterceptRequest dengan cara berikut:

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

Langkah 5: Kirim permintaan ke API pencarian MDES

1. Perbarui Program.cs dengan kode berikut:

 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. Gunakan consumerKey Anda sendiri, pkcs12KeyFilePath , signingKeyAlias , signingKeyAlias dan keyStorageFlags .
3. Klik Debug
4. Anda harus mendapatkan hasil yang mirip dengan yang ini: