Skip to content

matmiranda/pagbank-dotnet

Repository files navigation

pagbank-dotnet

license dotnet status nuget downloads nuget version coverage status

Bem-vindo ao repositório da pagbank-dotnet!

Esta biblioteca é uma solução poderosa para facilitar a integração de serviços RESTful em seus aplicativos .NET usando o RestSharp.

Visão Geral

A pagbank-dotnet foi desenvolvida para simplificar e agilizar a comunicação com APIs RESTful. Ela oferece recursos avançados e uma integração perfeita com o RestSharp para realizar operações assíncronas, processar dados, autenticar solicitações e muito mais.

Principais Recursos

  • Integração perfeita com o RestSharp para chamadas RESTful
  • Suporte a autenticação segura e gerenciamento de tokens
  • Operações assíncronas eficientes para não bloquear a thread principal
  • Abstração de dados para simplificar o processamento de respostas
  • Extensa documentação e exemplos práticos

Instalação

Para começar a usar a biblioteca pagbank-dotnet, siga estas etapas simples:

  1. Abra seu projeto .NET no Visual Studio ou em sua IDE preferida.

  2. Use o Gerenciador de Pacotes NuGet para adicionar a biblioteca ao seu projeto:

    Install-Package pagbank-dotnet

Documentação Oficial do PagBank

Para informações detalhadas sobre como usar a biblioteca pagbank-dotnet em conjunto com as APIs do PagBank, consulte a nossa Documentação Oficial.

Ambiente disponíveis

Você pode interagir com as APIs do PagBank por meio de dois ambientes: Sandbox e Produção, veja exemplo da tabela abaixo:

Ambiente Url
Sandbox https://sandbox.api.pagseguro.com
SandboxSecure https://secure.sandbox.api.pagseguro.com
SandboxSignature https://sandbox.api.assinaturas.pagseguro.com
Production https://api.pagseguro.com
ProductionSecure https://secure.api.pagseguro.com
ProductionSignature https://api.assinaturas.pagseguro.com

Exemplo de uso

using PagBank;

var client = new PagBankClient();
client.WithBaseUrl(BaseUrl.Sandbox);
client.WithMethod(PagBankMethod.Get);
client.WithToken("your-token");
client.WithResource("{seu_recurso}");

Exemplo de criar o pedido

var body = new PagBankBody
{
    Customer = new Customer
    {
        TaxId = "62046100077",
        Email = "[email protected]",
        Name = "Test"
    },
    ReferenceId = "1234"
};
client.WithBaseUrl(BaseUrl.Sandbox);
client.WithMethod(PagBankMethod.Post);
client.WithJsonBody(body);
client.WithToken("your-token");
client.WithResource("orders");
var response = await client.ExecuteAsync();

Exemplo de consultar pedidos

client.WithBaseUrl(BaseUrl.Sandbox);
client.WithMethod(PagBankMethod.Get);
client.WithToken("your-token");
client.WithResource("orders/ORDE_XXXXXXXX");
var response = await client.ExecuteAsync();

Testes Unitários Compatíveis

A biblioteca pagbank-dotnet é compatível e funcional com testes unitários usando a biblioteca de mocking Moq. Isso permite que você crie testes robustos para garantir a qualidade e a estabilidade da sua aplicação.

Veja um exemplo de como você pode testar um serviço utilizando Moq.

Saiba mais

Para mais detalhes e exemplos detalhados, consulte nossa Wiki.

Contribua e Ajude a Melhorar

Nós valorizamos sua contribuição para tornar a biblioteca pagbank-dotnet ainda melhor!

Se você encontrar erros, problemas ou tiver ideias para melhorias, fique à vontade para:

  • Abrir problemas (Issues) detalhados para relatar erros ou propor melhorias.
  • Enviar pull requests (PRs) com suas contribuições e correções.
  • Participar de discussões construtivas sobre o projeto.

Sua ajuda é fundamental para o sucesso contínuo da biblioteca!