mastercard mdes customer service net45 tutorial

.NET 4.5: ¿Cómo integrarse con el servicio al cliente MasterCard MDES?

Tabla de contenido

• Descripción general
• Requisitos previos
• Paso 1: Genere una biblioteca de clientes de .NET 4.5 API
• Paso 2: Abra y construya la solución generada
• Paso 3: Agregue un proyecto de aplicación de consola a la solución
• Paso 4: Extender a Apíclient para usar JSON
• Paso 5: Envíe solicitudes a la API de búsqueda de MDES

Descripción general

MasterCard proporciona bibliotecas de clientes para integrarse con sus servicios, pero los paquetes .NET no admiten .NET Framework 4.5, cuyo soporte terminó en 2016:

• El firmante C# OAuth1 Lib admite .NET Standard 1.3 (.NET Framework 4.6+)
• MasterCard Core y MasterCard MDES Servicio al cliente SDKS admite .NET Framework 4.6.1+

Este tutorial explica cómo consumir el servicio al cliente de MasterCard MDES de una aplicación .NET 4.5 generando una biblioteca de clientes API con el generador OpenAPI y firmando solicitudes HTTP utilizando una versión .NET 4.5 del firmante OAuth1 Lib.

Requisitos previos

1. Lea la documentación del servicio al cliente de MDES
2. Descargue la especificación de Servicio al cliente de MDES OpenAPI
3. Configure un proyecto en el portal de desarrolladores de MasterCard, agregue la API de servicio al cliente de MDES:

4. Verifique y cree la versión .NET 4.5 de la biblioteca de firmantes OAuth1

Paso 1: Genere una biblioteca de clientes de .NET 4.5 API

Se puede generar una biblioteca de clientes .NET 4.5 para el servicio al cliente de MDES utilizando el siguiente comando:

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

Ver también: OpenApi Generator (ejecutable)

Paso 2: Abra y construya la solución generada

1. Navegue a la carpeta MDES-Customer-Service-Net45-Tutorial/SRC
2. Corrige los archivos del proyecto (.csproj) eliminando Condition="Exists('....packages')" en elementos HintPath , ejemplo:

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

3. Abra yourapp.mdescustomerclient.sln
4. Haga clic en Build> Rebuild Solución

Paso 3: Agregue un proyecto de aplicación de consola a la solución

1. Haga clic en Archivo> Nuevo> Proyecto ...
2. Elija la aplicación de consola (.net framework) y configure el proyecto de la siguiente manera:

3. Haga clic derecho en las referencias y agregue las siguientes dependencias al proyecto YourApp.Console :
   • YourApp.MdesCustomerClient
   • Mastercard.Developer.OAuth1Signer.Core.dll (versión .net 4.5)
   • Mastercard.Developer.OAuth1Signer.RestSharp.dll (versión .net 4.5)
   • RestSharp.dll

Paso 4: Extender ApiClient para usar JSON

Por defecto, el servicio al cliente de MDES está aceptando y devuelve las cargas de XML cuando nuestro código generado espera que se use JSON.

Para indicar el servicio que hablamos JSON, cree una nueva clase en el proyecto YourApp.MdesCustomerClient Definiendo el método parcial InterceptRequest de la siguiente manera:

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

Paso 5: Envíe solicitudes a la API de búsqueda de MDES

1. Actualizar program.cs con el siguiente código:

 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. Use su propio consumerKey , pkcs12KeyFilePath , signingKeyAlias , signingKeyAlias y keyStorageFlags .
3. Haga clic en la depuración
4. Debería obtener un resultado similar a este: