GitHub - uzbekdev1/WirecardCSharp: 🔥 🚾 - API do Wirecard para .NET

O jeito mais simples e rápido de integrar o Wirecard a sua aplicação .NET e feito com base nas APIs REST do Wirecard.

Índice

Implementações .NET com suporte
Aviso Importante
Instalação
Autenticando e configurando o ambiente (E-Commerce)
Autenticando e configurando o ambiente (Marketplace)
Assíncrona x Síncrona
Conta Clássica
Conta Transparente
Clientes
Pedidos
Pagamentos
Multipedidos
Multipagamentos
Notificações
Contas Bancárias
Saldo Wirecard
Lançamentos
Transferências
Reembolsos
Conciliação
Convertendo objeto para json
Tabela - Filtros de busca
Exceção
Licença

Implementações .NET com suporte

Essa biblioteca foi feito em .NET Standard 1.2 e tem suporte das seguintes implementações do .NET:

.NET Core 1.0
.NET Framework 4.5.1
Mono 4.6
Xamarin.iOS 10.0
Xamarin.Android 7.0
Universal Windows Platform 10
Windows 8.1
Windows Phone 8.1

Para mais informações: .NET Standard.

Aviso Importante

Pensando em melhorar ainda mais a sua segurança e para atender a padrões internacionais do nosso selo PCI Compliance, o Wirecard desativará protocolos de segurança TLS (Transport Layer Security) inferiores a 1.2 à partir do dia 30/06/2018. Verifique se o seu projeto já possui TLS na versão 1.2, caso não, você receberá uma exceção:

- InnerException = {"A solicitação foi anulada: Não foi possível criar um canal seguro para SSL/TLS."}

Para isso, adicione o seguinte código no seu projeto:

System.Net.ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls12;

Para mais informações : TLS1.2.

Instalação

Execute o comando para instalar via NuGet:

PM> Install-Package WirecardCSharp

💥 Obs: Trocamos a biblioteca MoipCSharp por WirecardCSharp.

Autenticando e configurando o ambiente (E-Commerce)

Escolha o "ambiente" você quer executar suas ações e informe seu (token, chave):

using WirecardCSharp;
using WirecardCSharp.Models;

private const string token = "xxxxxxxxxxxxxxxxxxx";
private const string key = "xxxxxxxxxxxxxxxxxxxxxxxxxx";
private WirecardClient WirecardClient = new WirecardClient(Environments.SANDBOX, token, key);

Para obter um token e a chave, primeiro faça o login aqui.

Você pode acessá-las em Minha conta > Configurações > Chaves de Acesso.

Autenticando e configurando o ambiente (Marketplace)

Escolha o "ambiente" você quer executar suas ações e informe seu accesstoken:

using WirecardCSharp;
using WirecardCSharp.Models;

private const string accessToken = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxx_v2";
private WirecardClient WirecardClient = new WirecardClient(Environments.SANDBOX, accessToken);

Para obter o accesstoken, você precisa criar um App.

Assíncrona x Síncrona

Todos os métodos são assíncronos, caso você queira executar de forma síncrona, veja o exemplo:

var result = Task.Run(() => WirecardClient.Customer.List()).Result;

Conta Clássica

Verificar se usuário já possui Conta Wirecard (email)

🚩 Essa função funciona somente na conta clássica.

var result = await WirecardClient.ClassicAccount.AccountExist("[email protected]");
if (result == HttpStatusCode.OK)
{
    // já existe
    //HttpStatusCode.OK == 200 (já existe)
    //HttpStatusCode.BadRequest == 400 (CPF inválido)
    //HttpStatusCode.NotFound == 404 (Para CPF válido, mas não possui Conta Wirecard)
}

Verificar se usuário já possui Conta Wirecard (documento)

🚩 Essa função funciona somente na conta clássica.

var result = await WirecardClient.ClassicAccount.AccountExist("123.456.789-01");
if (result == HttpStatusCode.OK)
{
    // já existe
    //HttpStatusCode.OK == 200 (já existe)
    //HttpStatusCode.BadRequest == 400 (CPF inválido)
    //HttpStatusCode.NotFound == 404 (Para CPF válido, mas não possui Conta Wirecard)
}

Criar Conta Wirecard Clássica

var body = new ClassicAccountRequest
{
    //informe os campos aqui
};
var result = await WirecardClient.ClassicAccount.Create(body);

Consultar Conta Wirecard

var result = await WirecardClient.ClassicAccount.Consult("MPA-XXXXXXXXXXXX");

Solicitar Permissões de Acesso ao Usuário

🚩 O código a seguir não consome API, apenas monta o URL. Mais informações clica aqui.

string response_type = "code";
string client_id = "APP-FFFGVQMOK123";
string redirect_uri = "https://example.com/abc?DEF=あいう\x20えお";
string scope = "RECEIVE_FUNDS,MANAGE_ACCOUNT_INFO,DEFINE_PREFERENCES";
var url = Utilities.RequestUserAccessPermissions(response_type, client_id, redirect_uri, scope);

//https://connect-sandbox.moip.com.br/oauth/authorize?response_type=code&client_id=APP-
//FFFGVQMOK123&redirect_uri=https://example.com/abc?DEF=%E3%81%82%E3%81%84%E3%81%86%20%
//E3%81%88%E3%81%8A&scope=RECEIVE_FUNDS,MANAGE_ACCOUNT_INFO,DEFINE_PREFERENCES

Veja aqui como funciona a permissão.

Gerar Access Token

var result = await WirecardClient.ClassicAccount.GenerateAccessToken(/*informe o valor de cada parâmetro*/);

Atualizar accessToken

var result = await WirecardClient.ClassicAccount.UpdateAccessToken(/*informe o valor de cada parâmetro*/);

Obter chave pública de uma Conta Wirecard

var result = await WirecardClient.ClassicAccount.GetPublickey();

Conta Transparente

Criar Conta Wirecard Transparente

var body = new TransparentAccountRequest
{
    TransparentAccount = true,
    Type = "MERCHANT",
    Email = new Email
    {
        Address = "[email protected]"
    },
    Person = new Person
    {
        Name = "PrimeiroNome",
        LastName = "SegundoNome",
        TaxDocument = new Taxdocument
        {
            Type = "CPF",
            Number = "123.456.798-91"
        },
        BirthDate = "2011-01-01",
        Phone = new Phone
        {
            CountryCode = "55",
            AreaCode = "11",
            Number = "965213244"
        },
        Address = new Address
        {
            Street = "Av. Brigadeiro Faria Lima",
            StreetNumber = "2927",
            District = "Itaim",
            ZipCode = "01234000",
            City = "Osasco",
            State = "SP",
            Country = "BRA"
        }
    }
};
var result = await WirecardClient.TransparentAccount.Create(body);

Clientes

Criar Cliente

var body = new CustomerRequest
{
    //informe os campos aqui
};
var result = await WirecardClient.Customer.Create(body);

Adicionar Cartão de Crédito

var body = new CustomerRequest
{
    Method = "CREDIT_CARD",
    CreditCard = new Creditcard
    {
        ExpirationMonth = "06",
        ExpirationYear = "2022",
        Number = "4012001037141112",
        Cvc = "123",
        Holder = new Holder
        {
            FullName = "João da Silva",
            BirthDate = "1961-03-01",
            TaxDocument = new Taxdocument
            {
                Type = "CPF",
                Number = "11111111111"
            },
            Phone = new Phone
            {
                CountryCode = "55",
                AreaCode = "11",
                Number = "111111111"
            }
        }
    }
};
var result = await WirecardClient.Customer.AddCreditCard(body, "CUS-XXXXXXXXXXXX");

Deletar Cartão de Crédito

var result = await WirecardClient.Customer.DeleteCreditCard("CRC-XXXXXXXXXXXX");

Consultar Cliente

var result = await WirecardClient.Customer.Consult("CUS-XXXXXXXXXXXX");

Listar Todos os Clientes

var result = await WirecardClient.Customer.List();

Pedidos

Criar Pedido

var body = new OrderRequest
{
    //informe os campos aqui
};
var result = await WirecardClient.Order.Create(body);

Consultar Pedido

var result = await WirecardClient.Order.Consult("ORD-XXXXXXXXXXXX");

Listar Todos os Pedidos - Sem Filtros

var result = await WirecardClient.Order.List();

Listar Todos os Pedidos - Com Filtros

string filtros = "q=josesilva&filters=status::in(PAID,WAITING)|paymentMethod::in(CREDIT_CARD,BOLETO)|value::bt(5000,10000)&limit=3&offset=0";
var result = await WirecardClient.Order.ListFilter(filtros);

Veja a tabela filtros de busca aqui.

Pagamentos

Criar Pagamento - Cartão de Crédito

var body = new PaymentRequest
{
   //informe os campos aqui
   InstallmentCount = 1,
   FundingInstrument = new Fundinginstrument
   {
       Method = "CREDIT_CARD",
       CreditCard = new Creditcard
       {
           Id = "CRC-XXXXXXXXXXXX",
           Cvc = "123",
           Holder = new Holder
           {
               FullName = "Jose Portador da Silva",
               BirthDate = "1988-12-30",
               TaxDocument = new Taxdocument
               {
                   Type = "CPF",
                   Number = "33333333333"
               }
           }
       }
   }
};          
var result = await WirecardClient.Payment.Create(body, "ORD-XXXXXXXXXXXX");

Criar Pagamento - Boleto

var body = new PaymentRequest
{
    //informe os campos aqui
    StatementDescriptor = "Minha Loja",
    FundingInstrument = new Fundinginstrument
    {
        Method = "BOLETO",
        Boleto = new Boleto
        {
            ExpirationDate = "2020-06-20", //yyyy-MM-dd
            InstructionLines = new Instructionlines
            {
                First = "Atenção",
                Second = "fique atento à data de vencimento do boleto.",
                Third = "Pague em qualquer casa lotérica."
            }
        }        
    }
};
var result = await WirecardClient.Payment.Create(body, "ORD-XXXXXXXXXXXX");

Liberação de Custódia

var result = await WirecardClient.Payment.ReleaseCustody("ECW-XXXXXXXXXXXX");

Capturar Pagamento Pré-autorizado

var result = await WirecardClient.Payment.CaptureAuthorized("PAY-XXXXXXXXXXXX");

Cancelar Pagamento Pré-autorizado

var result = await WirecardClient.Payment.CancelAuthorized("PAY-XXXXXXXXXXXX");

Consultar Pagamento

var result = await WirecardClient.Payment.Consult("PAY-XXXXXXXXXXXX");

Simular Pagamentos (sandbox)

var result = await WirecardClient.Payment.Simulate("PAY-XXXXXXXXXXXX", 26500);

Multipedidos

Criar Multipedido

var body = new MultiOrderRequest
{
    //informe os campos aqui
};            
var result = await WirecardClient.MultiOrder.Create(body);

Consultar Multipedido

var result = await WirecardClient.MultiOrder.Consult("MOR-XXXXXXXXXXXX");

Multipagamentos

Criar Multipagamento

var body = new MultiPaymentRequest
{
    //informe os campos aqui
};            
var result = await WirecardClient.MultiPayment.Create(body, "MOR-XXXXXXXXXXXX");

Consultar Multipagamento

var result = await WirecardClient.MultiPayment.Consult("MPY-XXXXXXXXXXXX");

Capturar Multipagamento Pré-autorizado

var result = await WirecardClient.MultiPayment.CaptureAuthorized("MPY-XXXXXXXXXXXX");

Cancelar Multipagamento Pré-autorizado

var result = await WirecardClient.MultiPayment.CancelAuthorized("MPY-XXXXXXXXXXXX");

Liberação de Custódia

var result = await WirecardClient.MultiPayment.ReleaseCustody("ECW-XXXXXXXXXXXX");

Notificações

Criar Preferência de Notificação para Conta Wirecard

var body = new NotificationRequest
{
    //informe os campos aqui
};            
var result = await WirecardClient.Notification.CreatAccountWirecard(body);

Criar Preferência de Notificação para App

Caso não tenha uma URL disponível, você pode usar o Webhook Tester para fazer seus testes e receber os webhooks.

Para isso basta acessar o site e gera uma URL automaticamente.

var body = new NotificationRequest
{
    Events = new List<string> { "ORDER.*" },
    Target = "https://webhook.site/a54daf-da54-8d5a-8d5d1-kfa4gahf42",
    Media = "WEBHOOK"
};           
var result = await WirecardClient.Notification.CreateApp(body, "APP-XXXXXXXXXXXX");

Consultar Preferência de Notificação

var result = await WirecardClient.Notification.Consult("NPR-XXXXXXXXXXXX");

Listar Todas as Preferências de Notificação

var result = await WirecardClient.Notification.List();

Remover Preferência de Notificação

var result = await WirecardClient.Notification.Remove("NPR-XXXXXXXXXXXX");
if (result == HttpStatusCode.NoContent)
{
    // Caso a Preferência de Notificação tenha sido deletada, você deve receber uma response vazia (NoContent)
}

Consultar Webhook Enviado

var result = await WirecardClient.Notification.ConsultWebhook("PAY-XXXXXXXXXXXX");

Listar Todos os Webhooks Enviados

var result = await WirecardClient.Notification.ListWebhooks();

Desserializar WebHook

Ao configurar suas Preferências de Notificação você deve receber os webhooks em formato JSON e você pode desserializar.

var json = "{ \"date\": \"\", \"env\": \"\", ... }";
var result = Utilities.DeserializeWebHook(json);

Veja um exemplo do webhook aqui.

Contas Bancárias

Criar Conta Bancária

var body = new BankAccountRequest
{
    bankNumber = "237",
    agencyNumber = "12345",
    agencyCheckNumber = "0",
    accountNumber = "12345678",
    accountCheckNumber = "7",
    type = "CHECKING",
    holder = new Holder
    {
        taxDocument = new Taxdocument
        {
            type = "CPF",
            number = "622.134.533-22"
        },
        fullname = "Demo Wirecard"
    }
};
string accesstoken = "XXXXXXXXXXXXXXXXXXXXXXXXXXX_v2"; // accesstoken do recebedor
var result = await WirecardClient.BankAccount.Create(body, accesstoken, "MPA-XXXXXXXXXXXX");

Consultar Conta Bancária

string accesstoken = "XXXXXXXXXXXXXXXXXXXXXXXXXXX_v2"; // accesstoken do recebedor
var result = await WirecardClient.BankAccount.Consult(accesstoken, "BKA-XXXXXXXXXXXX");

Listar Todas Contas Bancárias

string accesstoken = "XXXXXXXXXXXXXXXXXXXXXXXXXXX_v2"; // accesstoken do recebedor
var result = await WirecardClient.BankAccount.List(accesstoken, "MPA-XXXXXXXXXXXX");

Deletar Conta Bancária

string accesstoken = "XXXXXXXXXXXXXXXXXXXXXXXXXXX_v2"; // accesstoken do recebedor
var result = await WirecardClient.BankAccount.Delete(accesstoken, "BKA-XXXXXXXXXXXX");

Atualizar Conta Bancária

var body = new BankAccountRequest
{
    //informe os campos aqui
};
string accesstoken = "XXXXXXXXXXXXXXXXXXXXXXXXXXX_v2"; // accesstoken do recebedor
var result = await WirecardClient.BankAccount.Update(body, accesstoken, "BKA-XXXXXXXXXXXX");

Saldo Wirecard

Consultar Saldos

var result = await WirecardClient.Balance.Consult();

Lançamentos

Consultar Lançamento

var result = await WirecardClient.Launch.Consult("ENT-XXXXXXXXXXXX");

Listar Todos Lançamentos

var result = await WirecardClient.Launch.List();

Listar Todos Lançamentos com Filtro

string filtros = "filters=status::in(SETTLED)";
var result = await WirecardClient.Launch.ListFilter(filtros);

Transferências

Criar Transferência

var body = new TransferRequest
{
    //informe os campos aqui
};
string accessToken = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxx_v2";
var result = await WirecardClient.Transfer.Create(body, accessToken);

Reverter Transferência

string accessToken = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxx_v2";
var result = await WirecardClient.Transfer.Revert("TRA-XXXXXXXXXXXX", accessToken);

Consultar Transferência

string accessToken = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxx_v2";
var result = await WirecardClient.Transfer.Consult("TRA-XXXXXXXXXXXX", accessToken);

Listar Todas Transferências

var result = await WirecardClient.Transfer.List();

Listar Todas Transferências com filtros

string filtros = "filters=transferInstrument.method::in(MOIP_ACCOUNT)&limit=3&offset=0";
var result = await WirecardClient.Transfer.List();

Reembolsos

Reembolsar Pagamento

var body = new RefundRequest
{
    //informe os campos aqui
};            
var result = await WirecardClient.Refund.RefundPayment(body, "PAY-XXXXXXXXXXXX");

Reembolsar Pedido via Cartão de Crédito

var body = new RefundRequest
{
    //informe os campos aqui
};            
var result = await WirecardClient.Refund.RefundRequestCreditCard(body, "ORD-XXXXXXXXXXXX");

Consultar Reembolso

var result = await WirecardClient.Refund.Consult("REF-XXXXXXXXXXXX");

Listar Reembolsos do Pagamento

var result = await WirecardClient.Refund.ListPayments("PAY-XXXXXXXXXXXX");

Listar Reembolsos do Pedido

var result = await WirecardClient.Refund.ListOrders("ORD-XXXXXXXXXXXX");

Conciliação

Obter Arquivo de Vendas

var result = await WirecardClient.Conciliation.GetSalesFile("20180829"); // Data no formato YYYYMMDD

Obter Arquivo Financeiro

var result = await WirecardClient.Conciliation.GetFinancialFile("2018-08-29"); // Data no formato YYYY-MM-DD

Convertendo objeto para json

As vezes você enfrenta um problema e o suporte Wirecard pede o código json para verificar se realmente está no json:

using Newtonsoft.Json;

var body = new PaymentRequest
{
    //informe os campos aqui
    DelayCapture = true,
    InstallmentCount = 1,
    FundingInstrument = new Fundinginstrument
    {
        Method = "CREDIT_CARD",
        CreditCard = new Creditcard
        {
            Id = "CRC-XXXXXXXXXXXX",
            Cvc = "123",
            Holder = new Holder
            {
                FullName = "Jose Portador da Silva",
                BirthDate = "1988-12-30",
                TaxDocument = new Taxdocument
                {
                    Type = "CPF",
                    Number = "33333333333"
                }
            }
        }
    }
};

//Aqui você pode obter json e compratilhar para suporte Wirecard
string json = JsonConvert.SerializeObject(body, Formatting.Indented);

Veja como ficou na variável json:

{
  "installmentCount": 1,
  "delayCapture": true,
  "fundingInstrument": {
    "method": "CREDIT_CARD",
    "creditCard": {
      "id": "CRC-XXXXXXXXXXXX",
      "cvc": "123",
      "holder": {
        "fullname": "Jose Portador da Silva",
        "birthdate": "1988-12-30",
        "taxDocument": {
          "type": "CPF",
          "number": "33333333333"
        }
      }
    }
  }
}

Tabela - Filtros de busca

Nome	Tipo	Descrição
limit	int	Quantidade de registros por busca (página). O valor default é 20
offset	int	Registro a partir do qual a busca vai retornar. O valor default é 0
gt(x)	number or date	Maior que - “Greater Than”
ge(x)	number or date	Maior ou igual - “Greater than or Equal”
lt(x)	number or date	Menor que - “Less Than”
le(x)	number or date	Menor ou igual - “Less than or Equal”
bt(x,y)	string	Entre - “Between”
in(x,y…z)	string	Em - “IN”
q		Consulta um valor em específico

✅ Fazendo uma busca com os seguintes requisitos:

+ Transações de valores entre 5000 e 10000 (em centavos);
+ Formas de pagamento: Cartão de Crédito e Boleto;
+ Cliente com o nome jose silva;
+ Retornando 3 resultados.

GET https: //sandbox.moip.com.br/v2/orders?q=jose silva &filters=status::in(PAID,WAITING)|paymentMethod::in(CREDIT_CARD,BOLETO) |value::bt(5000,10000)&limit=3&offset=0

Você pode também fazer uma busca por pedidos dentro de um intervalo de tempo:

GET https: //sandbox.moip.com.br/v2/orders?filters=createdAt::bt(2017-10-10T13:07:00Z,2017-10-25T13:08:00Z)

Exceção

Obter erros

Você pode recuperar os atributos code, path, description, message e error, veja no exemplo abaixo:

using WirecardCSharp.Exception;

try
{
    var result = await WC.Customer.Create(new CustomerRequest());
}
catch (WirecardException ex)
{
    var t = ex.wirecardError;
    var t_text = ex.GetExceptionText();
}

Tabela de erros

Nome	Descrição	Detalhe
code	Código identificador do erro	string
path	Parâmetro relacionado ao erro	string
description	Descrição do erro	string
message	Mensagem do retorno Wirecard	string

Licença

The MIT License

Tem dúvidas? Fale com a gente no Slack! Algum problema ? Abre issues!

Name		Name	Last commit message	Last commit date
Latest commit History 403 Commits
WirecardCSharp		WirecardCSharp
.gitattributes		.gitattributes
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
WirecardCSharp.sln		WirecardCSharp.sln

License

uzbekdev1/WirecardCSharp

Folders and files

Latest commit

History

Repository files navigation

Índice

Implementações .NET com suporte

Aviso Importante

Instalação

Autenticando e configurando o ambiente (E-Commerce)

Autenticando e configurando o ambiente (Marketplace)

Assíncrona x Síncrona

Conta Clássica

Verificar se usuário já possui Conta Wirecard (email)

Verificar se usuário já possui Conta Wirecard (documento)

Criar Conta Wirecard Clássica

Consultar Conta Wirecard

Solicitar Permissões de Acesso ao Usuário

Gerar Access Token

Atualizar accessToken

Obter chave pública de uma Conta Wirecard

Conta Transparente

Criar Conta Wirecard Transparente

Clientes

Criar Cliente

Adicionar Cartão de Crédito

Deletar Cartão de Crédito

Consultar Cliente

Listar Todos os Clientes

Pedidos

Criar Pedido

Consultar Pedido

Listar Todos os Pedidos - Sem Filtros

Listar Todos os Pedidos - Com Filtros

Pagamentos

Criar Pagamento - Cartão de Crédito

Criar Pagamento - Boleto

Liberação de Custódia

Capturar Pagamento Pré-autorizado

Cancelar Pagamento Pré-autorizado

Consultar Pagamento

Simular Pagamentos (sandbox)

Multipedidos

Criar Multipedido

Consultar Multipedido

Multipagamentos

Criar Multipagamento

Consultar Multipagamento

Capturar Multipagamento Pré-autorizado

Cancelar Multipagamento Pré-autorizado

Liberação de Custódia

Notificações

Criar Preferência de Notificação para Conta Wirecard

Criar Preferência de Notificação para App

Consultar Preferência de Notificação

Listar Todas as Preferências de Notificação

Remover Preferência de Notificação

Consultar Webhook Enviado

Listar Todos os Webhooks Enviados

Desserializar WebHook

Contas Bancárias

Criar Conta Bancária

Consultar Conta Bancária

Listar Todas Contas Bancárias

Deletar Conta Bancária

Atualizar Conta Bancária

Saldo Wirecard

Consultar Saldos

Lançamentos

Consultar Lançamento

Listar Todos Lançamentos

Listar Todos Lançamentos com Filtro

Transferências

Criar Transferência

Reverter Transferência

Consultar Transferência

Listar Todas Transferências

Listar Todas Transferências com filtros

Reembolsos

Packages