Mercado Pago .Net

Inglês / Espanhol

O SDK oficial do Mercado Pago.

💡 Requisitos

.NET Standard 2.1+, .NET Core 2.0+, e .NET Framework 6.0+.

Se você estiver usando versões anteriores do .NET Framework em seu projeto, consulte as versões mais antigas do SDK.

📲 Instalação

Usando o .NET Core command-line interface (CLI) tools

dotnet add package mercadopago-sdk

Usando o NuGet Command Line Interface (CLI)

nuget install mercadopago-sdk

Usando o Package Manager

Install-Package mercadopago-sdk

No Visual Studio

1. Abra o Solution Explorer.
2. Clique com o botão direito em um projeto da sua solução.
3. Clique em Manage NuGet Packages....
4. Clique na tab Browse e busque por "mercadopago-sdk".
5. Clique no package mercadopago-sdk, selecione a versãa apropriada e clique em Install.

🌟 Iniciando

Primeira vez usando o Mercado Pago? Crie sua conta do Mercado Pago.

Copie seu Access Token do painel de credenciais e substitua o texto YOUR_ACCESS_TOKEN com ele.

Uso simples

Para gerar um card token leia a documentação do Checkout Transparente.

using System;
using System.Threading.Tasks;
using MercadoPago.Client.Payment;
using MercadoPago.Config;
using MercadoPago.Resource.Payment;

MercadoPagoConfig.AccessToken = "YOUR_ACCESS_TOKEN";

var request = new PaymentCreateRequest
{
    TransactionAmount = 10,
    Token = "CARD_TOKEN",
    Description = "Payment description",
    Installments = 1,
    PaymentMethodId = "visa",
    Payer = new PaymentPayerRequest
    {
        Email = "test.payer@email.com",
    }
};

var client = new PaymentClient();
Payment payment = await client.CreateAsync(request);

Console.WriteLine($"Payment ID: {payment.Id}");

Configuração por requisição

Todos os métodos que realizam chamadas às APIs aceitam um objeto opcional RequestOptions. Isto pode ser utilizado para configurar algumas opções especiais da requisição, como a alteração das próprias credenciais ou headers personalizados.

using MercadoPago.Client;

var requestOptions = new RequestOptions();
requestOptions.AccessToken = "YOUR_ACCESS_TOKEN";
// ...

var client = new PaymentClient();
Payment payment = await client.CreateAsync(request, requestOptions);

Uso avançado

Usar um servidor de proxy

using System.Net;
using System.Net.Http;
using MercadoPago.Config;
using MercadoPago.Http;

var handler = new HttpClientHandler
{
    Proxy = new WebProxy(proxyUrl),
    UseProxy = true,
};
var httpClient = new HttpClient(handler);
MercadoPagoConfig.HttpClient = new DefaultHttpClient(httpClient);

Configurar retentativas automáticas

O SDK automaticamente retenta as requisições no caso de falhas intermitentes. O número máximo de tentativas default é 2.

using MercadoPago.Config;
using MercadoPago.Http;

var retryStrategy = new DefaultRetryStrategy(5);
MercadoPagoConfig.RetryStrategy = retryStrategy;

📚 Documentação

Visite nosso Developer Site para mais informações sobre:

• APIs
• Checkout Pro
• Checkout Transparente
• Web Tokenize Checkout

Veja nosso SDK docs para explorar todas as funcionalidades disponíveis.

🤝 Contribuindo

Todas as contribuições são bem-vindas, desde pessoas que desejam fazer a triagem de issues, outras que desejam escrever documentação, até pessoas que desejam contribuir com código.

Por favor, leia e siga nossas diretrizes de contribuição. As contribuições que não seguirem essas diretrizes serão desconsideradas. As diretrizes existem para facilitar todas as nossas vidas e tornar a contribuição um processo consistente para todos.

❤️ Suporte

Se você necessita de suporte técnico, por favor entre em contato com nosso time de suporte em developers.mercadopago.com

🏻 Licença

MIT license. Copyright (c) 2021 - Mercado Pago / Mercado Libre
Para mais informação, veja o arquivo LICENSE.