asaasSdk

Asaas SDK para Java

SDK Java oficial para integração com a API do Asaas, desenvolvido por @jpdev01 para facilitar o desenvolvimento de aplicações que utilizam os serviços de pagamento do Asaas.

📋 Índice

• Instalação
• Início Rápido
• Configuração
• Recursos
• Exemplos de Uso
• Documentação Completa
• Suporte e Contribuição

🚀 Começando

Novo no SDK? Comece pelo Guia de Início Rápido para estar operacional em minutos!

🚀 Instalação

Maven

Adicione a dependência no seu pom.xml:

<dependency>
    <groupId>io.github.jpdev01</groupId>
    <artifactId>asaassdk</artifactId>
    <version>4</version>
</dependency>

Gradle

implementation 'io.github.jpdev01:asaassdk:1.4'

⚡ Início Rápido

1. Inicialização

Antes de realizar qualquer requisição, inicialize o SDK com sua chave de API:

import io.github.jpdev.asaassdk.Asaas;

public class Main {
    public static void main(String[] args) {
        // Ambiente de produção
        Asaas.init("sua_chave_api");

        // Ou ambiente sandbox para testes
        Asaas.initSandbox("sua_chave_api_sandbox");
    }
}

Para o guia completo de ínicio rápido veja Quick Start

⚙️ Configurações adicionais

Configurações adicionais

🎯 Recursos

O SDK oferece suporte completo para todos os recursos da API Asaas:

Pagamentos e Cobranças

• ✅ Cobranças (Boleto, PIX, Cartão de Crédito)
• ✅ Cobranças Parceladas
• ✅ Split de Pagamentos
• ✅ Links de Pagamento
• ✅ Assinaturas Recorrentes
• ✅ Estornos

PIX

• ✅ QR Code Estático e Dinâmico
• ✅ Chaves PIX (Criar, Listar, Deletar)
• ✅ Transações PIX
• ✅ PIX Automático (Débito Recorrente)
• ✅ Pagamento via QR Code

Transferências

• ✅ TED
• ✅ PIX
• ✅ Transferências Internas (entre contas Asaas)
• ✅ Transferências Recorrentes

Gestão de Conta

• ✅ Clientes
• ✅ Subcontas
• ✅ Saldo e Extrato
• ✅ Dados Comerciais
• ✅ Taxas da Conta
• ✅ Status da Conta

Outros

• ✅ Webhooks
• ✅ Notificações
• ✅ Notas Fiscais
• ✅ Pagamento de Contas (Boletos)

📖 Documentação Completa

Guias por Funcionalidade

🚀 Começando

• Guia de Início Rápido - Primeiros passos com o SDK

Pagamentos

• Cobranças - Criar, listar, estornar cobranças
• Cobranças com Split - Divisão de pagamentos
• Links de Pagamento - Criar links de checkout
• Assinaturas - Pagamentos recorrentes
• Parcelamentos - Gestão de parcelas

PIX

• PIX - QR Code e Chaves - Gerenciar chaves e QR codes
• PIX - Transações - Enviar e receber PIX
• PIX Automático - Débito recorrente via PIX

Transferências e Pagamentos

• Transferências - TED, PIX e transferências internas
• Pagar Contas - Pagamento de boletos

Gestão

• Clientes - CRUD de clientes
• Subcontas - Gerenciar subcontas
• Saldo - Consultar saldo
• Extrato - Transações financeiras
• Dados Comerciais - Informações da empresa
• Status da Conta - Situação da conta
• Taxas - Consultar taxas
• Número de Conta - Dados bancários

Notificações e Integrações

• Webhooks - Configurar notificações automáticas
• Notificações - Gerenciar notificações
• Notas Fiscais - Emitir NF-e

Configurações

• Configurações Extras - Sandbox, timeout, rate limit
• Rate Limit - Limites de requisição

Recursos Adicionais

• Exemplos Completos
• Documentação Oficial da API Asaas
• Repositório Maven

🔒 Segurança

• Nunca exponha suas chaves de API em código público
• Use variáveis de ambiente para armazenar credenciais
• Utilize o ambiente sandbox para testes
• Implemente validação de webhooks para garantir autenticidade

// Exemplo usando variável de ambiente
String apiKey = System.getenv("ASAAS_API_KEY");
Asaas.init(apiKey);

🐛 Tratamento de Erros

try {
    Payment payment = Payment.creator()
        .setCustomer("cus_invalid")
        .setBillingType(BillingType.PIX)
        .setDueDate(new Date())
        .setValue(Money.create(new BigDecimal("100.00")))
        .create();
} catch (AsaasException e) {
    System.err.println("Erro ao criar cobrança: " + e.getMessage());
    // Trate o erro apropriadamente
}

📊 Análise de Qualidade

O projeto é continuamente analisado pelo SonarQube. Confira o relatório completo:

• SonarCloud - Análise de Código

🤝 Suporte e Contribuição

Reportar Problemas

Encontrou um bug ou tem uma sugestão? Abra uma issue no GitHub.

Contribuir

Contribuições são bem-vindas! Sinta-se à vontade para abrir Pull Requests com as alterações

Comunidade

• GitHub
• Documentação Asaas

📝 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

🙏 Agradecimentos

Desenvolvido com ❤️ por @jpdev01

---

Nota: Este SDK não é oficial e não possui vínculo direto com o Asaas. Para suporte oficial da API, consulte a documentação do Asaas.

This site is open source. Improve this page.