An open API service indexing awesome lists of open source software.

https://github.com/gerencianet/gn-api-sdk-dotnet-core

SDK em .NET Core integrada a API Gerencianet. Esta SDK está preparada para integração à API Pix e API Boletos da Gerencianet, que lhe permite realizar o gerenciamento de cobranças Pix com QR Code e Pix Copia e Cola, boleto/Bolix, carnê, cartão de crédito e muito mais.
https://github.com/gerencianet/gn-api-sdk-dotnet-core

assinatura billet boleto bolix card carne carnet cartao-de-credito csharp dotnet dotnet-core link-de-pagamento marketplace pix pix-copia-e-cola qrcode sdk split subscription

Last synced: 5 months ago
JSON representation

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

Awesome Lists containing this project

README

          

# gn-api-sdk-dotnet-core

> A .NET Core library for integration of your application with the payment services
provided by [Gerencianet](http://gerencianet.com.br).

## Installation

From Visual Studio package manager:

```bash
PM> Install-Package Gerencianet.NETCore.SDK -Version 3.0.0
```

From .NET Cli:

```bash
> dotnet add package Gerencianet.NETCore.SDK --version 3.0.0
```

### Tested with
```
.NET 5.0

```
## Atenção
- O .NET 5.0 é a versão principal do .NET Core após a versão 3.1. O "Core" foi removido do nome para enfatizar que essa é a implementação principal do .NET no futuro. O .NET 5.0 dá suporte a mais tipos de aplicativos e mais plataformas do que o .NET Core ou .NET Framework. Por esse motivo, optamos por concentrar todas as atualizações relacionadas ao dotnet apenas nessa SDK.
- A Gerencianet está disponibilizando um novo endpoint para requisitar o envio de Pix, este endpoint passará a ter um idEnvio como parâmetro na requisição, além disso o método passa a ser o PUT ao invés do POST para fins de idempotência. O método anterior foi descontinuado e o exemplo foi atualizado.
- Os endpoints da API Open Finance e API de Pagamentos só estão disponíveis em ambiente de produção. Por este motivo, neste cenário o atributo sandbox é desconsiderado.

## Basic usage

```c#
using Gerencianet.NETCore.SDK;
...
dynamic endpoints = new Endpoints("client_id", "client_secret", true, "production.p12");

var body = new
{
calendario = new {
expiracao = 3600
},
devedor = new {
cpf = "12345678909",
nome = "Francisco da Silva"
},
valor = new {
original = "1.45"
},
chave = "71cdf9ba-c695-4e3c-b010-abb521a3f1be",
solicitacaoPagador = "Informe o número ou identificador do pedido."
};

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

## Examples

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

Just remember to set the correct credentials inside `Gerencianet.NETCore.SDK.Examples/credentials.json` before running.

## Additional documentation

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

## Changelog

[CHANGELOG](CHANGELOG.MD)

## Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/gerencianet/gn-api-sdk-dotnet-core. 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](LICENSE).