Akatus

Biblioteca
para
Integrao com .NET
Caique Dourado http://www.caiquedourado.com.br

Documentao da API Akatus: http://connect.akatus.com/documentacao/#api

SUMRIO
Configurao ................................................................................................................................................................. 3
Carrinho ........................................................................................................................................................................ 4
Processar Transao ................................................................................................................................................. 4
Meios de Pagamento..................................................................................................................................................... 6
Obter os meios de pagamento ativos em sua conta Akatus...................................................................................... 6
Opes de Parcelamento............................................................................................................................................... 7
Obter as opes de parcelamento para um determinado meio de pagamento e valor do pedido ............................ 7
Consulta Status ............................................................................................................................................................. 8
Obter o status de uma transao.............................................................................................................................. 8
NIP Notificao Instantnea de Pagamento ................................................................................................................ 9
Recebe uma notificao da Akatus informando a mudana do status de pagamento de uma transao.................. 9
Tratamento de Erros ....................................................................................................................................................10

CONFIGURAO
Adicione no Web.Config sua API Key, o Tken NIP, o E-mail utilizado no cadastro da Akatus, e o Ambiente ('producao'
ou 'testes').
<appSettings>
<!-- Akatus - Ambiente ('producao' ou 'testes')-->
<add key="AkatusAmbiente" value="testes"/>
<!-- Akatus - API Key -->
<add key="AkatusApiKey" value="SUA-API-KEY"/>
<!-- Akatus - Tken NIP -->
<add key="AkatusTokenNIP" value="SEU-TOKEN-NIP"/>
<!-- Akatus - E-mail da Conta -->
<add key="AkatusEmail" value="emaildecadastro@empresa.com.br"/>
</appSettings>

CARRINHO
PROCESSAR T RANSAO
Akatus.Carrinho.Carrinho carrinho = new Akatus.Carrinho.Carrinho();
//Nome e E-mail do Comprador
carrinho.Pagador.Nome = "NOME CLIENTE";
carrinho.Pagador.Email = "email@cliente.com";
//Adiciona Endereo do Comprador
Akatus.Carrinho.PagadorEndereco endereco = new Akatus.Carrinho.PagadorEndereco();
endereco.Tipo = Akatus.Enums.TipoEndereco.entrega;
endereco.Logradouro = "Rua Teste da Silva";
endereco.Numero = 0;
endereco.Bairro = "CENTRO";
endereco.Cidade = "Salvador";
endereco.Estado = "BA";
endereco.Pais = "BRA";
endereco.CEP = "40000000";
carrinho.Pagador.Enderecos.Add(endereco);
//Adiciona Telefone do Comprador
Akatus.Carrinho.PagadorTelefone telefone = new Akatus.Carrinho.PagadorTelefone();
telefone.Tipo = Akatus.Enums.TipoTelefone.celular;
telefone.Numero = "7199990000";
carrinho.Pagador.Telefones.Add(telefone);
//Adiciona Produto
Akatus.Carrinho.Produto produto = new Akatus.Carrinho.Produto();
produto.Codigo = "ABC1234567";
produto.Descricao = "Caixa de bombons sortidos";
produto.Quantidade = 1;
produto.Preco = 32.25m;
produto.Frete = 0;
produto.Peso = 0;
produto.Desconto = 0;
carrinho.Produtos.Add(produto);
//Forma de Pagamento (Boleto)
//carrinho.Transacao.MeioDePagamento = Akatus.Enums.MeioDePagamento.boleto;
//carrinho.Transacao.DescontoTotal = 0;
//carrinho.Transacao.PesoTotal = 0;
//carrinho.Transacao.FreteTotal = 0;
//carrinho.Transacao.Moeda = "BRL";
//carrinho.Transacao.Referencia = "OFP12345";
//Forma de Pagamento (Carto de Crdito)
carrinho.Transacao.MeioDePagamento = Akatus.Enums.MeioDePagamento.cartao_master;
carrinho.Transacao.Referencia = "OFP12345";
carrinho.Transacao.Cartao.Numero = "5453010000066167";
carrinho.Transacao.Cartao.NumeroParcelas = 2;
carrinho.Transacao.Cartao.CodigoSeguranca = "123";
carrinho.Transacao.Cartao.Expiracao = "05/2018";
carrinho.Transacao.Cartao.Portador.Nome = "AUTORIZAR";
carrinho.Transacao.Cartao.Portador.CPF = "721.726.663-78";
carrinho.Transacao.Cartao.Portador.Telefone = "7199990000";

carrinho.Transacao.DescontoTotal = 0;
carrinho.Transacao.PesoTotal = 0;
carrinho.Transacao.FreteTotal = 0;
carrinho.Transacao.Moeda = "BRL";
//Envia carrinho
Akatus.Carrinho.Retorno retorno = carrinho.processaTransacao();

MEIOS DE PAGAMENTO
OBTER OS MEIOS DE PAGAMENTO ATIVOS EM SUA CONTA AKATUS
Akatus.ConsultaMeiosPagamento.Consulta consulta = new
Akatus.ConsultaMeiosPagamento.Consulta();
//Consulta meios de pagamento
List<Akatus.ConsultaMeiosPagamento.Retorno> retorno =
consulta.consultaMeiosDePagamentoDisponiveis();

OPES DE PARCELAMENTO
OBTER AS OPES DE PARCELAMENTO PARA UM DETERMINADO MEIO DE PAGAMENTO E VALOR DO
PEDIDO
Akatus.ConsultaParcelamento.Consulta consulta = new Akatus.ConsultaParcelamento.Consulta();
//Consulta opes de parcelamento
Akatus.ConsultaParcelamento.Retorno retorno = consulta.consultaParcelamento(10.39m,
Akatus.Enums.MeioDePagamento.cartao_visa);

CONSULTA STATUS
OBTER O STATUS DE UMA TRANSAO
Akatus.ConsultaStatus.Consulta consulta = new Akatus.ConsultaStatus.Consulta();
//Consulta status da transao
Akatus.ConsultaStatus.Retorno retorno = consulta.consultaStatusTransacao("00000000-0000-00000000-0000000000");

NIP NOTIFICAO INSTANTNEA DE PAGAMENTO

RECEBE UMA NOTIFICAO DA AKATUS INFORMANDO A MUDANA DO STATUS DE PAGAMENTO DE
UMA TRANSAO
//Pega
string
string
string
string

parmetros postados
token = Request.Form["token"];
transacao_id = Request.Form["transacao_id"];
status = Request.Form["status"];
referencia = Request.Form["referencia"];

//Processa retono da transao

Akatus.NotificacaoPagamento.Retorno retorno =
Akatus.NotificacaoPagamento.Notificacao.processaRetorno(token, transacao_id, status,
referencia);

TRATAMENTO DE ERROS
try
{
//CODE
}
catch (Akatus.RestExcepction ex)
{
//Show http status
Response.Write(ex.StatusCode);
Response.Write(ex.StatusDesciption);
//Show error messages
foreach (string error in ex.ErrorMessages)
{
Response.Write("<br />" + error);
}
}
catch (Exception ex) {
//Show exception message
Response.Write(ex);
}