gerencianet / gn-api-sdk-dotnet Goto Github PK

SDK em .NET integrada a API Gerencianet. Esta SDK está preparada para integração à API Boletos da Gerencianet, que lhe permite realizar o gerenciamento de cobranças com boleto/Bolix, carnê, cartão de crédito e muito mais.

Home Page: https://dev.gerencianet.com.br/docs/instalacao-sdk-dotnet

License: MIT License

C# 100.00%

marketplace split subscription sdk dotnet assinatura card cartao-de-credito boleto billet

gn-api-sdk-dotnet's Introduction

gn-api-sdk-dotnet

A .NET library for integration of your application with the payment services provided by Gerencianet.

Installation

From Visual Studio package manager:

PM> Install-Package Gerencianet.SDK -Version 1.0.8

From .NET Cli:

> dotnet add package Gerencianet.SDK --version 1.0.8

Tested with

dotnet 4.0.0

Basic usage

using Gerencianet.SDK;
...
dynamic endpoints = new Endpoints("client_id", "client_secret", true);
var body = new
{
    items = new[] {
        new {
            name = "Product 1",
            value = 1000,
            amount = 2
        }
    },
    shippings = new[] {
        new {
            name = "Default Shipping Cost",
            value = 100
        }
    }
};

var response = endpoints.CreateCharge(null, body);
Console.WriteLine(response);

Examples

You can run the examples contained in the project Gerencianet.SDK.Examples by uncommenting the lines in Program.cs file.

Just remember to set the correct credentials inside Gerencianet.SDK.Examples/Credentials.Settings before running.

Tests

To run the tests, build Gerencianet.SDK.Tests and use nunit3-console:

$ nunit3-console ./Gerencianet.SDK.Tests/bin/Release/Gerencianet.SDK.Tests.dll

Additional documentation

The full documentation with all available endpoints is in https://dev.gerencianet.com.br/.

Changelog

CHANGELOG

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/gerencianet/gn-api-sdk-dotnet. This project is intended to be a safe, welcoming space for collaboration.

License

The library is available as open source under the terms of the MIT License.

gn-api-sdk-dotnet's People

Contributors

Stargazers

Watchers

Forkers

jbsolucoes lcslima hugoj-goncalves sadycoimbraefi sufficit thiagoluiz andersonplima

gn-api-sdk-dotnet's Issues

Erro com Envio Boleto/Autenticação de múltiplas contas

Em meu sistema utilizo envio de Boletos de diversas contas e quando isso acontece o SDK continua a usar o Token (devido ser static) com dados da primeira conta enviada.
Por exemplo, vamos supor que eu precise criar 2 boletos e meu usuário ao lado dos boletos ele tem a opção de selecionar a "conta de cobrança" de cada boleto. Quando envio o primeiro boleto ele faz a autenticação e salva o token com o clientId e clienteSecret do primeiro boleto. A enviar o segundo boleto, o Gerencianet.SDK verificar se o token(nesse caso com dados do primeiro boleto) está nulo (Endpoint.cs, linha 57), se não tiver nulo ele usa o Token(com dados do primeiro boleto).

Ou seja, independente do clientId e clienteSecret passados no construtor do Endpoint.cs, ele sempre vai usar os dados da primeira autenticação. Ele faz a transmissão porem a conta que ele recebe é diferente da desejada.

Possível solução: criar um objeto "TokenValueObject" que sera composto do Token, ClientId e ClientSecret, e ao invés de armazenar somente o token, armazenar dados do client do token, salvar esse TokenValueObject e a cada requisiçaõ de autenticação comparar alem do token os dados do Client entre o token e os dados passado no construtor do Endpoint.cs.

Caso seja necessário posso efetuar a alteração e enviar um PR para analise.

Alexandre Laranjeiras
[email protected]

Possibilidade de gerar o payment_token

De acordo com a documentação "Para aplicações web, você deve copiar o script acima, específico da sua conta, e utilizar a nossa biblioteca Javascript, conforme o snippet abaixo. Se você possui um app mobile, confira como proceder acessando nossa página no GitHub para Android e/ou iOS."

No meu caso, estou desenvolvendo um app mobile em Xamarin, então não consigo integrar nem utilizando o Javascript e nem com as bibliotecas nativas de Android e iOS.

Existe a possibilidade de tornar possível gerar o payment_token nessa biblioteca, semelhante ao que é feito aqui https://github.com/gerencianet/gn-api-sdk-android ?

Se não for possível, qual a melhor solução para o meu cenário?

Obrigado!

PIX

Tem previsão para implementar PIX nesta API?

"key $type must not start with '$'"

Olá, estou tendo problemas com a parte do callback da API. A resposta que recebo do servidor é essa somente:
"key $type must not start with '$'"

Estou implementando em .NET Core 5 com o pacote nuget de API 1.0.9.
Alguém sabe como resolver?