Mercado Pago .Net

Inglês / Portugues

El SDK oficial de Mercado Pago.

💡 Requisitos

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

Si estás utilizando versiones anteriores del .NET Framework en tu proyecto, consulta las versiones anteriores del SDK.

📲 Instalación

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

dotnet add package mercadopago-sdk

Usando el NuGet Command Line Interface (CLI)

nuget install mercadopago-sdk

Usando el Package Manager

Install-Package mercadopago-sdk

En el Visual Studio

1. Abra el Solution Explorer.
2. Haga clic con el botón derecho en un proyecto de su solución.
3. Haga clic en Manage NuGet Packages....
4. Haga clic en la tab Browse y busque "mercadopago-sdk".
5. Haga clic en el package mercadopago-sdk, seleccione la versión apropiada y haga clic en Install.

🌟 Empezando

¿Primera vez usando Mercado Pago? Crea tu cuenta de Mercado Pago.

Copie su Access Token del panel de credenciales y reemplace el texto YOUR_ACCESS_TOKEN con él.

Uso simple

Para generar un card token lea la documentación del 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}");

Configuración por solicitud

Todos los métodos de los que realizan llamadas a APIs aceptan un objeto RequestOptions opcional. Esto puede ser utilizado para configurar algunas opciones especiales de la solicitud, como el propio cambio de credenciales o headers presonalizados.

using MercadoPago.Client;

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

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

Uso avanzado

Usar un servidor 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 reintentos automáticos

El SDK reintenta automáticamente las solicitudes en caso de fallas intermitentes. El número máximo de intentos default es 2.

using MercadoPago.Config;
using MercadoPago.Http;

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

📚 Documentación

Visite nuestro Developer Site para obtener más información sobre:

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

Consulte nuestro SDK docs para explorar todas las funciones disponibles.

🤝 Contribuyendo

Todas las contribuciones son bienvenidas, desde personas que deseen filtrar las issues, otras que quieran escribir documentación, hasta personas que quieran contribuir con código.

Lea y siga nuestras pautas de contribución. Las contribuciones que no sigan estas pautas no se tendrán en cuenta. Las pautas están establecidas para hacernos la vida más fácil y hacer que la contribución sea un proceso consistente para todos.

❤️ Soporte

Si necesitas asistencia técnica, póngase en contacto con nuestro equipo de asistencia en developers.mercadopago.com.

🏻 Licencia

MIT license. Copyright (c) 2021 - Mercado Pago / Mercado Libre
Para obtener más información, consulte el archivo LICENSE.