mastercard mdes customer service net45 tutorial

.NET 4.5: كيفية الاندماج مع خدمة عملاء MasterCard MDES؟

جدول المحتويات

• ملخص
• المتطلبات الأساسية
• الخطوة 1: قم بإنشاء مكتبة عميل API .NET 4.5
• الخطوة 2: فتح وإنشاء الحل الذي تم إنشاؤه
• الخطوة 3: إضافة مشروع تطبيق وحدة التحكم إلى الحل
• الخطوة 4: تمديد apiclient لاستخدام JSON
• الخطوة 5: إرسال طلبات إلى MDES Search API

ملخص

يوفر MasterCard مكتبات العملاء للتكامل مع خدماتها ، لكن حزم .NET لا تدعم .NET Framework 4.5 ، التي انتهى دعمها في عام 2016:

• يدعم Signer LIB C# OAUTH1 .NET Standard 1.3 (.NET Framework 4.6+)
• Mastercard Core و Mastercard MDES Customer Service SDKs Support .NET Framework 4.6.1+

يشرح هذا البرنامج التعليمي كيفية استهلاك خدمة عملاء MasterCard MDES من تطبيق .NET 4.5 عن طريق إنشاء مكتبة عميل API مع مولد OpenAPI وتوقيع طلبات HTTP باستخدام إصدار .NET 4.5 من Signer LIB.

المتطلبات الأساسية

1. اقرأ وثائق خدمة عملاء MDES
2. قم بتنزيل مواصفات خدمة عملاء MDES OpenAPI
3. قم بإعداد مشروع في بوابة MasterCard Developers ، أضف واجهة برمجة تطبيقات خدمة عملاء MDES إليها:

4. الخروج وبناء إصدار .NET 4.5 من مكتبة Signer OAUTH1

الخطوة 1: قم بإنشاء مكتبة عميل API .NET 4.5

يمكن إنشاء مكتبة عميل .NET 4.5 لخدمة عملاء MDES باستخدام الأمر التالي:

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

انظر أيضًا: Openapi Generator (قابل للتنفيذ)

الخطوة 2: فتح وإنشاء الحل الذي تم إنشاؤه

1. انتقل إلى مجلد MDES-Customer-Service-Net45-Tutorial/SRC
2. إصلاح ملفات المشروع (.csproj) عن طريق حذف Condition="Exists('....packages')" في عناصر HintPath ، مثال:

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

3. افتح yourapp.mdescustomerclient.sln
4. انقر فوق بناء> إعادة بناء الحل

الخطوة 3: إضافة مشروع تطبيق وحدة التحكم إلى الحل

1. انقر فوق ملف> جديد> مشروع ...
2. اختر تطبيق Console (.NET Framework) وتكوين المشروع بالطريقة التالية:

3. انقر بزر الماوس الأيمن على المراجع وأضف التبعيات التالية إلى مشروع YourApp.Console :
   • YourApp.MdesCustomerClient
   • Mastercard.Developer.OAuth1Signer.Core.dll (.NET 4.5 الإصدار)
   • Mastercard.Developer.OAuth1Signer.RestSharp.dll (.NET 4.5 الإصدار)
   • RestSharp.dll

الخطوة 4: تمديد ApiClient لاستخدام JSON

بشكل افتراضي ، تقوم خدمة عملاء MDES بقبول وإعادة حمولة XML عندما تتوقع رمزنا الذي تم إنشاؤه استخدام JSON.

للإشارة إلى الخدمة التي نتحدث عنها JSON ، قم بإنشاء فصل جديد في مشروع YourApp.MdesCustomerClient الذي يحدد الطريقة الجزئية InterceptRequest بالطريقة التالية:

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

الخطوة 5: إرسال طلبات إلى MDES Search API

1. تحديث برنامج .

 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. استخدم consumerKey الخاص ، pkcs12KeyFilePath ، signingKeyAlias ​​، signingKeyAlias ​​و keyStorageFlags .
3. انقر فوق تصحيح
4. يجب أن تحصل على نتيجة مشابهة لهذا: