mastercard mdes customer service net45 tutorial

.NET 4.5: Como se integrar ao atendimento ao cliente MasterCard MDES?

Índice

• Visão geral
• Pré -requisitos
• Etapa 1: gerar uma biblioteca de clientes da API .NET 4.5
• Etapa 2: abra e construa a solução gerada
• Etapa 3: adicione um projeto de aplicativo de console à solução
• Etapa 4: estenda o apiclient para usar o JSON
• Etapa 5: Envie solicitações para a API de pesquisa do MDES

Visão geral

A MasterCard fornece bibliotecas clientes para integrar seus serviços, mas os pacotes .NET não suportam o .NET Framework 4.5, cujo apoio terminou em 2016:

• O Significador C# OAuth1 Lib suporta .NET Standard 1.3 (.NET Framework 4.6+)
• MasterCard Core e MasterCard MDES Atendimento ao cliente SDKS SUPORTE .NET Framework 4.6.1+

Este tutorial explica como consumir o atendimento ao cliente da MasterCard MDES a partir de um aplicativo .NET 4.5, gerando uma biblioteca de clientes da API com o gerador OpenAPI e assinando solicitações HTTP usando uma versão .NET 4.5 do Signer OAuth1 Lib.

Pré -requisitos

1. Leia a documentação do Serviço ao Cliente do MDES
2. Faça o download da especificação do Aberto do Atenção ao Cliente do MDES
3. Configure um projeto no MasterCard Developers Portal, adicione a API de atendimento ao cliente do MDES:

4. Confira e construa a versão .NET 4.5 da biblioteca OAuth1 Signer

Etapa 1: gerar uma biblioteca de clientes da API .NET 4.5

Uma biblioteca de clientes .NET 4.5 para o atendimento ao cliente do MDES pode ser gerada usando o seguinte 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 " 
}

Veja também: gerador OpenAPI (executável)

Etapa 2: abra e construa a solução gerada

1. Navegue até a pasta MDES-Customer-Service-Net45-Tutorial/SRC
2. Corrija os arquivos do projeto (.csproj) por excluir Condition="Exists('....packages')" em elementos HintPath , exemplo:

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

3. Abra o seupp.mdescustomerclient.sln
4. Clique em Construir> Solução de reconstrução

Etapa 3: adicione um projeto de aplicativo de console à solução

1. Clique em Arquivo> Novo> Projeto ...
2. Escolha o aplicativo Console (.NET Framework) e configure o projeto da seguinte maneira:

3. Clique com o botão direito do mouse nas referências e adicione as seguintes dependências ao projeto YourApp.Console :
   • YourApp.MdesCustomerClient
   • Mastercard.Developer.OAuth1Signer.Core.dll (versão .NET 4.5)
   • Mastercard.Developer.OAuth1Signer.RestSharp.dll (versão .NET 4.5)
   • RestSharp.dll

Etapa 4: estenda ApiClient para usar o JSON

Por padrão, o Atendimento ao Cliente do MDES está aceitando e retornando cargas úteis XML quando nosso código gerado espera que o JSON seja usado.

Para indicar o serviço, falamos JSON, crie uma nova classe no projeto YourApp.MdesCustomerClient Definindo o método parcial InterceptRequest da seguinte maneira:

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

Etapa 5: Envie solicitações para a API de pesquisa do MDES

1. Update Program.cs com o seguinte 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 seu próprio consumerKey , pkcs12KeyFilePath , signingKeyAlias , signingKeyAlias e keyStorageFlags .
3. Clique em Debug
4. Você deve obter um resultado semelhante a este: