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

Usar una de las siguientes opciones, dependiendo de tu entorno preferido.

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.

Usando el Package Manager

Install-Package mercadopago-sdk

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

🌟 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 MercadoPago.Config;
using MercadoPago.Client.Common;
using MercadoPago.Client.Order;
using MercadoPago.Resource.Order;
using System.Collections.Generic;

MercadoPagoConfig.AccessToken = "{{ACCESS_TOKEN}}";

var request = new OrderCreateRequest
{
    Type = "online",
    TotalAmount = "1000.00",
    ExternalReference = "ext_ref_1234",
    Transactions = new OrderTransactionRequest
    {
        Payments = new List<OrderPaymentRequest>
            {
                new OrderPaymentRequest
                {
                    Amount = "1000.00",
                    PaymentMethod = new OrderPaymentMethodRequest
                    {
                        Id = "master",
                        Type = "credit_card",
                        Token = "{{CARD_TOKEN}}",
                        Installments = 1,
                    }
                }
            }
    },
    Payer = new OrderPayerRequest
    {
        Email = "{{PAYER_EMAIL}}",
    }
};

var client = new OrderClient();
Order order = client.Create(request);
Console.WriteLine(Newtonsoft.Json.JsonConvert.SerializeObject(order, Newtonsoft.Json.Formatting.Indented));

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;
using MercadoPago.Http;
using MercadoPago.Client.Order;
using MercadoPago.Resource.Order;

var requestOptions = new RequestOptions();
requestOptions.AccessToken = "YOUR_ACCESS_TOKEN";
requestOptions.CustomHeaders.Add(Headers.IDEMPOTENCY_KEY, "YOUR_IDEMPOTENCY_KEY");

// ...
var client = new OrderClient();
Order order = client.Create(request, requestOptions);

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.