MaisTodos.Client 3.5.4

Biblioteca de integração MaisTodos em .NET

Descrição

A biblioteca de integração MaisTodos em .NET facilita a utilização das funcionalidades que a MaisTodos expõe na forma de APIs.

Inclui funcionalidades como:

• Obter Cliente por Id
• Registrar Cliente
• Obter Assinatura por Id
• Criar Assinatura Associando a um Cliente
• Cancelar Assinatura por Id
• Estornar Pagamento
• Adicionar Cartão de Crédito
• Obter Ciclos de Pagamentos Pendentes Para uma Assinatura
• Criar um Ciclo de Pagamento Futuro para uma Assinatura
• Obter Último Ciclo de Pagamento pela Assinatura
• Baixar Manualmente os Ciclos de Uma Assinatura
• Baixar Manualmente os Ciclos de Uma Assinatura (Forma Simplificada)
• Criar um Cupom de Desconto
• Criar uma Regra de Descontos
• Obter um Cupom de Desconto por Id
• Obter os Cupons de Desconto
• Obter uma Regra de Desconto por Id
• Obter as Regras de Desconto
• Alterar a Referência da Assinatura
• Trocar o Método (Reguá) de Pagamento
• Alterar o preço de uma Assinatura
• Gerar uma Cobrança Adicional Para a Assinatura
• Obter o Cliente pelo Documento de Identificação
• Suspender Assinatura por Id
• Atualizar cupom e desconto
• Abrir uma assinatura suspensa por Id
• Fazer uma nova tentativa de pagamento por Id do pagamento
• Obter o ultimo ciclo de pagamento por Id

Requisitos

• .NET Standard 2.0

Instalação

.Net Cli

dotnet add package MaisTodos.Client --version 3.5.4

PackageReference

<PackageReference Include="MaisTodos.Client" Version="3.5.4" />

Utilização

Instância do cliente da mais todos:

using MaisTodos.Client;

IMaisTodosClient maisTodosClient = new MaisTodosClient(
    authorization: "token xxxx",
    apiVersion: "v1",
    isSandBox: true // true para utilização em sandbox e false para utilização em produção
    mockEndpointBaseUrl: null  // Opicional - Usado para mocar o retorno do estorno de tentativa
);

Obter Cliente por Id:

var customerId = 1;
var resultValue = await maisTodosClient.GetCustomersByIdAsync(customerId);
var client = resultValue.Data;

Registrar Cliente:

var client = new CustomerDTO {
    Name = "Name1",
    Document = "Document1",
    Phone = "XXXXXXXXXX",
    Email = "XXXXXXXXXX@email.com",
    Address = "Address1",
    AddressNumber = "5",
    Complement = "Complement1",
    Neighborhood = "Neighborhood1",
    City = "City1",
    State = "mg",
    Zipcode = "Zipcode1",
    Latitude = "-30.770001",
    Longitude = "45.899002"
};
var resultValue = await maisTodosClient.RegisterCustomersAsync(client);
var registeredCustomer = resultValue.Data;

Obter Assinatura por Id:

var subscriptionId = 1;
var resultValue = await maisTodosClient.GetSubscriptionByIdAsync(subscriptionId);
var subscription = resultValue.Data;

Criar Assinatura Associando a um Cliente:

var dto = new CreateSubscriptionLinkingCustomerDTO
{
    Plan = 1,
    Customer = 1,
    NextBillingDate = "xxxx-xx"

    PaymentData = new PaymentDataRequestDTO
    {
        PaymentRuler = 1,
        Installments = 1,
        CreditCard = new CreditCardDTO
        {
Holder = "Holder A",
Number = "XXXXXXXXXXXXXX",
CVV = "123",
ExpirationDate = "2030-01",
Brand = "master"
        }
    }
};
var resultValue = await maisTodosClient.CreateSubscriptionLinkingCustomerAsync(dto);
var subscription = resultValue.Data;

Cancelar Assinatura por Id:

var subscriptionId = 1;
var dto = new ObservationDTO
{
    Observation = "Cancelado pelo motivo X"
};
var resultValue = await _maisTodosClient.CancelSubscriptionByIdAsync(
    subscriptionId: subscriptionId, dto: dto
);
var subscription = resultValue.Data;

Estornar Pagamento:

var attemptId = 1;
var dto = new ObservationDTO
{
    Observation = "Estornado pelo motivo X"
};
var resultValue = await _maisTodosClient.RefundByAttemptIdAsync(
    attemptId: attemptId, dto: dto
);
var subscription = resultValue.Data;

Adicionar Cartão de Crédito

var dto = new AddCreditCardDTO
{
    Customer = 1,
    Holder = "XXXXX",
    Number = "XXXXXXXXXXXXXXXX",
    CVV = "XXX",
    ExpirationDate = "XXXX-XX",
    Default = true,
    Brand = "master"
};

var resultValue = await _maisTodosClient.AddCreditCardAsync(dto: dto);
var response = resultValue.Data;

Adicionar Cartão de Crédito por Token

var dto = new AddCreditCardByTokenDTO
{
    Customer = 1,
    Holder = "XXXXX",
    Token = "XXX",
    ExpirationDate = "XXXX-XX",
    Default = true,
    Brand = "master"
};

var resultValue = await _maisTodosClient.AddCreditCardByTokenAsync(dto: dto);
var response = resultValue.Data;

Obter Ciclos de Pagamentos Pendentes Para uma Assinatura

var subscriptionId = 1;

var resultValue = await _maisTodosClient.GetPaymentCyclesBySubscriptionIdAsync(subscriptionId);

var response = resultValue.Data;

Criar um Ciclo de Pagamento Futuro para uma Assinatura

var subscriptionId = 1;

var resultValue = await _maisTodosClientWithMock.CreateFutureCycleAsync(
    subscriptionId: subscriptionId
);

var response = resultValue.Data;

Baixar Manualmente os Ciclos de Uma Assinatura

var subscriptionId = 1;

var paymentCycleDTO = new ForcePaymentCompletionDTO()
{
    Observation = "Alguma observação sobre o motivo desse pagamento forçado.",
    CyclesIds = new List<int> { 1, 2 }
};

var resultValue = await _maisTodosClient.ForceCompletionOfPaymentCycleAsync(
    subscriptionId: subscriptionId, dto: paymentCycleDTO
);

var response = resultValue.Data;

Baixar Manualmente os Ciclos de Uma Assinatura (Forma Simplificada)

var subscriptionId = 1;
var observation = "Alguma observação sobre o motivo desse pagamento forçado";
var referencia = "2021/07";

var resultValue = await _maisTodosClient.ForceCompletionOfPaymentCycleAsync(
    subscriptionId: subscriptionId, observation: observation, monthOfYearCompetence: referencia
);

var response = resultValue.Data;

Criar um Cupom de Desconto

var coupon = new CouponDTO()
{
    Code = "CUPOM_XXX_01",
    IsActive = true,
    StartsAt = new DateTime(year: 2020, month: 1, day: 1),
    EndsAt = new DateTime(year: 2020, month: 3, day: 1)
};

var resultValue = await _maisTodosClient.CreateCouponAsync(
    coupon: coupon
);
var response = resultValue.Data;

Criar uma Regra de Descontos

var discount = new DiscountDTO()
{
    Id = null,
    CouponId = 1,
    Name = $"Regra X1",
    Rules = new List<DiscountRuleDTO>()
    {
        new DiscountRuleDTO(){
            Value =  10,
            StartCycle = 1,
            EndCycle = 2,
            DiscountType = DiscountType.percentual
        },
        new DiscountRuleDTO(){
            Value =  7.52m,
            StartCycle = 1,
            EndCycle = 2,
            DiscountType = DiscountType.value
        }
    }
};

var resultValue = await _maisTodosClient.CreateDiscountAsync(
    discount: discount
);
var response = resultValue.Data;

Obter um Cupom de Desconto por Id

var couponId = 1;

var resultValue = await _maisTodosClient.GetCouponsAsync(
    couponId: couponId
);
var response = resultValue.Data;

Obter os Cupons de Desconto

var resultValue = await _maisTodosClient.GetDiscountsAsync();
var response = resultValue.Data;

Obter uma Regra de Desconto por Id

var discountId = 1;

var resultValue = await _maisTodosClient.GetDiscountByIdAsync(
    discountId: discountId
);
var response = resultValue.Data;

Obter as Regras de Desconto

var resultValue = await _maisTodosClient.GetDiscountsAsync();
var response = resultValue.Data;

Atualizar um Cupom por Id

var couponId = 1;
CouponDTO coupon = new CouponDTO()
{
    IsActive = false;
};

var resultValue = await _maisTodosClient.UpdateCouponAsync(couponId: couponId, coupon: coupon);
var response = resultValue.Data;

Atualizar um Desconto por Id

var discountId = 1;
DiscountDTO discount = new DiscountDTO()
{
    Rules = new List<DiscountRuleDTO>()
    {
        new DiscountRuleDTO() { Value =  25 }
    };
};

var resultValue = await _maisTodosClient.UpdateDiscountAsync(discountId: discountId, discount: discount);
var response = resultValue.Data;

Obter Último Ciclo de Pagamento pela Assinatura

var subscriptionId = 1;

var resultValue = await _maisTodosClient.GetLastPaymentCycleBySubscriptionIdAsync(subscriptionId);
var response = resultValue.Data;

Alterar a Referência da Assinatura

var subscriptionId = 1;
var referenceDTO = new ReferenceDTO()
{
    Reference = "123"
};
var resultValue = await _maisTodosClient
    .ChangeSubscriptionReferenceAsync(subscriptionId: subscriptionId, reference: referenceDTO);
var response = resultValue.Data;

Trocar o Método (Reguá) de Pagamento

var subscriptionId = 1;
var paymentRulerDTO = new PaymentRulerDTO()
{
    PaymentRuler = 1
};
var resultValue = await _maisTodosClient
    .ChangeSubscriptionPaymentMethodAsync(subscriptionId: subscriptionId, paymentRuler: paymentRulerDTO);
var response = resultValue.Data;

Alterar o preço de uma Assinatura

var subscriptionId = 1;
var priceDTO = new PriceDTO()
{
    Price = 21.28m
};
var resultValue = await _maisTodosClient.UpdateSubscriptionPriceAsync(subscriptionId: subscription.Id, price: priceDTO);
var response = resultValue.Data;

Gerar uma Cobrança Adicional Para a Assinatura

var subscriptionId = 1;
var extraBillRequestDTO = new ExtraBillRequestDTO()
{
    Amount = 27.14m,
    PaymentType = 1
};
var resultValue = await _maisTodosClient
    .CreateExtraBillToSubscriptionAsync(subscriptionId: subscription.Id, extraBillRequest: extraBillRequestDTO);
var response = resultValue.Data;

Suspender Assinatura por Id:

var subscriptionId = 1;
var observationDTO = new ObservationDTO
{
    Observation = "Suspensa pelo motivo X"
};
var resultValue = await _maisTodosClient.SuspendSubscriptionByIdAsync(
    subscriptionId: subscriptionId, observationDTO: dto
);
var subscription = resultValue.Data;

Changelog

• 3.5.4 - altera o metodo put para post do endpoint abrir assinatura
• 3.5.3 - implementa Endpoints
  • Abrir uma assinatura suspensa por Id
  • Fazer uma nova tentativa de pagamento por Id do pagamento
  • Obter o ultimo ciclo de pagamento por Id
• 3.5.2 - Correção do campo NextBillingDate
• 3.5.1 - Implementa o campo NextBillingDate
• 3.4.0 - Atualizar cupom e desconto
• 3.3.1 - Suspender Assinatura por Id
• 3.3.0 - Obter o Cliente pelo Documento de Identificação
• 3.2.6 - Obter Último Ciclo de Pagamento pela Assinatura