Asaas - Cartão de Crédito

Introdução

A integração entre o Sistema e a plataforma de pagamentos Asaas foi criada para automatizar processos financeiros e de vendas, oferecendo uma forma de pagamento eficiente e segura. Neste documento, você encontrará detalhes sobre como essa integração funciona, seus benefícios e como realizar as configurações necessárias.

Solução Oferecida

Meio de pagamento para pagamentos via cartão de crédito de forma individual e recorrente.

Acesso ao Formulário

Caminho: Sistema > Cadastros > Financeiro > Carteira de cobrança.

Benefícios da Integração

Benefício	Descrição
Automação	Reduz o trabalho manual e aumenta a eficiência do processo
Flexibilidade de Pagamento	Permite pagamentos no cartão de crédito de forma individual ou recorrente
Receita Previsível	Cobranças recorrentes ajudam a manter o fluxo de caixa estável
Conveniência para Clientes	Menos atrasos e interrupções de serviço com pagamentos recorrentes

Estrutura

Como funciona a integração

1. Configuração
2. Acesso à Central do Assinante
3. Escolha da Opção de Pagamento
4. Preenchimento dos dados do Cartão de Crédito
5. Habilitação da Recorrência

Etapas de configuração do módulo

• Configuração da integração com o cartão de crédito.
• Juros, multas e desconto.
• Configuração da tarefa que realiza a cobrança das recorrências.

Campos obrigatórios

• Descrição: nome da carteira de cobrança.
• Conta: cadastro da conta bancária associada à carteira.
• Tipo de recebimento: tipo de integração que será usada para gerar as cobranças.
• Validar filial na venda: se marcado como Sim, a filial do Contrato do Cliente deve ser igual à da carteira de cobrança.
• Ativo: ativa ou desativa o cadastro da carteira no sistema.

Processo de Integração e Homologação

Para integrar e homologar a funcionalidade de Integração de Cartão de Crédito Asaas no sistema, siga os passos abaixo:

Homologação

Para iniciar a integração, abra um atendimento com o setor Suporte Financeiro e tenha em mãos os seguintes dados:

Dados Necessários

461 - Asaas (API Cartão de Crédito)

• 1 - Número da agência com dígito?
• 2 - Número da conta com dígito?
• 3 - Wallet ID?
• 4 - Chave de API?

Dica!

Em caso de dúvidas sobre seus dados bancários, entre em contato com o(a) Gerente de sua Conta Bancária.

Passo a passo para obter as Credenciais da API

Informação!

Para homologar a Carteira de Cartão de Crédito Asaas, é necessário gerar o Wallet ID e a Chave de API, diretamente dentro do Internet Banking do Asaas.

1. Acesse o Internet Banking Asaas.
2. Faça login com sua conta.
3. No canto superior direito, clique no menu de conta e selecione o botão Integrações.
4. Clique em Gerar nova chave de API.
5. Logo abaixo, na seção Wallet ID, copie o identificador da carteira.
6. Guarde esses dois códigos, pois eles serão usados para criar a carteira.

Credenciais API Finalizadas!

Com esses dados e suas demais informações bancárias, o suporte da IXC Soft dará continuidade à homologação da carteira de cobrança com Cartão de Crédito.

Criando a Carteira

1. Acesse o menu Sistema.
2. Pasta Financeiro.
3. Clique em Carteira de cobrança.
4. Clique em Novo.

Aviso!

Antes de configurar, vá à aba Impressão e, no campo Layout de Impressão, escolha o modelo: Boleto + fatura detalhada.

Como a cobrança no cartão não gera um documento específico, essa configuração permitirá a emissão de uma fatura com os detalhes necessários.

5. Na aba Carteira de cobrança, preencha os seguintes campos:

• Descrição: Nome que identificará a carteira.
• Conta: Conta bancária criada para armazenar os dados.
• Tipo de recebimento: Selecione Cartão de crédito.
• Enviar e-mail para cliente ao gerar: Marque como Não, pois obriga o e-mail do cliente e envia a fatura automaticamente ao banco (essa opção não é recomendada).
• Validar filial na venda: Marque como Não.
• Ativo: Marque como Sim.
• Filial: Apague o cadastro clicando no botão X que aparece ao lado.
• Planejamento analítico: Use o padrão 240, ou crie um novo.

Criando a Conta

• Conta: Nome para identificar a conta.
• Tipo da Conta: Escolha Banco.
• Data de abertura: Informe a data da criação da conta.
• Planejamento analítico: Para mais detalhes, acesse: Formulário Planejamento Analítico.
• Filial: Escolha o ID da filial à qual essa conta e carteira serão associadas.

Na aba Banco:

• Banco: ID da instituição financeira, neste caso:
  • 461 - Asaas
• Agência: Número da agência.
• Dígito verificador da agência: Número após o da agência.
• Número da conta: Número da sua conta.
• Dígito verificador da conta: Dígito final do número da conta.

Configurações Cartão de Crédito

• Gateway: Escolha Asaas.
• Ambiente gateway: Selecione Produção.
• Wallet ID: Insira o código criado no Asaas.
• Chave de API: Insira a chave gerada anteriormente.
• Máximo de parcelas: Por padrão, coloque 1 para pagamento à vista, ou altere conforme desejar permitir parcelamentos.
• Juro (% ao mês): Informe o percentual cobrado em parcelamentos, válido apenas se houver mais de uma parcela.
• Repassar taxa para o cliente: Marque como “Sim” para que a taxa da transação seja somada na fatura do cliente; marcando “Não”, ele pagará apenas o valor do produto ou serviço.

Redirecionar Taxas (Nova Função)

Melhoria!

Agora é possível redirecionar as taxas de transação da integração com Cartão de Crédito para o cliente, aplicável tanto para pagamentos manuais quanto recorrentes.

Se marcar Repassar taxa para o cliente como “Sim”, os seguintes campos serão exibidos:

• Será aplicada em pagamentos: Escolha entre Individuais, Recorrentes ou Ambos.
• Porcentagem da taxa (%): Percentual que será somado ao valor original.
• Valor fixo da taxa (R$): Valor em Reais que será acrescido no pagamento.

Aviso!

• Individuais: Aplica-se apenas a pagamentos únicos feitos na Central do Assinante.
• Recorrentes: Válido para cobranças com recorrência ativada.
• Ambos: Ativa a taxa para os dois tipos de pagamento.

Juros/Multas/Desconto

• Juros %: Utilize 0.033%, valor máximo permitido por lei.
• Multa %: Configure 2%, limite permitido por lei.
• Desconto até o vencimento R$: Informe o valor em reais.
• Desconto até o vencimento %: Informe a porcentagem.

Para mais detalhes, acesse: Juros, Multas e Desconto.

Aviso!

A Integração de Cartão de Crédito Asaas não tem valor mínimo exigido para gerar uma cobrança.

Dica!

Ao finalizar, clique em Salvar para concluir a configuração da carteira. Em seguida, ative a carteira no sistema, conforme instruções a seguir, para liberar seu uso pelos clientes.

Ativando a Carteira de Cobrança no Sistema

Com a carteira configurada, existem duas maneiras de ativar seu uso pelos clientes:

• Hotsite (Central do Assinante): Vinculando a carteira nos parâmetros gerais do sistema, todos os clientes poderão utilizá-la na Central do Assinante.
• Alternativa de Pagamento: Ao vincular a carteira a uma Alternativa de Pagamento, você pode usá-la somente com clientes específicos ou criar diferentes condições de pagamento.

Configurando a Carteira no Hotsite - Central do Assinante

1. Acesse o menu Sistema.
2. Vá até o submenu Hotsite.
3. Entre na pasta Configurações.
4. Clique em Configurações Geral.
5. Vá à aba Financeiro.
6. Ajuste os campos de Cartão de Crédito e Recorrência com Cartão de Crédito.
7. Clique em Salvar.

Dica!

Veja o passo a passo completo no documento Configurar Recorrência com Cartão de Crédito.

Configurando a Carteira como Alternativa de Pagamento

1. Crie a Alternativa de Pagamento, conforme explicado em Configurações Alternativas de Pagamento.
2. Acesse Sistema > Cadastros > Financeiro > Carteira de Cobrança.
3. Localize a carteira desejada e clique em Editar.
4. No campo Configuração de alternativa de pagamento, digite o ID ou busque a alternativa usando a Lupa.
5. Clique em Salvar.

Concluído!

Apenas os clientes com carteiras vinculadas à Alternativa de Pagamento configurada com opção de cartão de crédito poderão usar essa modalidade.

Tarefa de Baixa de Títulos em Recorrência

Após ativar sua carteira, configure uma tarefa automática que realize a baixa de títulos recorrentes no mesmo dia do vencimento.

Siga os passos:

1. Acesse o menu Ferramentas.
2. Clique em Ferramentas.
3. Vá para Agenda de tarefas.
4. Clique no botão Novo.
5. Tarefa: Escolha Baixar títulos cartão de crédito recorrente.
6. Minuto (0-59): Escolha os minutos entre 0 e 59.
7. Hora (0-23): Escolha a hora entre 0 e 23.

Dica!

É recomendável configurar a tarefa para rodar apenas uma vez por dia, em um horário que não conflite com outras tarefas.

Fluxos e Processos

Fluxo de Integração

sequenceDiagram
    participant S as Sistema
    participant API as API Asaas
    participant W as Webhook

    S->>API: Envia requisição (ex: gerar fatura)
    API->>S: Responde com dados da fatura
    Note over API,W: Evento ocorre (ex: pagamento)
    W->>S: Notifica sobre o evento
    S->>API: Confirma recebimento da notificação

Considerações finais

A integração entre a Asaas e o Sistema representa um avanço importante para a gestão financeira dos provedores de serviço.

Ela oferece mais automação, reduz custos e melhora o atendimento aos clientes, apontando para um futuro financeiro mais prático e eficiente.

Etiquetas

IntegracaoFinanceira Asaas PagamentosOnline CartaoDeCredito APIAsaas Recorrencia

Leia Também

• Carteira de Cobrança
• Financeiro
• Integrações Bancárias - Carteira de Cobrança
• Recorrência com Cartão de Crédito
• Como o Cliente Ativa a Recorrência
• Como o Cliente Cancela a Recorrência
• Verificar Financeiro Recorrente com Cartão
• Relatório de Contratos em Recorrência
• Logs Gateway
• Como Reprocessar Logs Gateway
• Localizar Pagamentos - Logs Gateway
• Logs de Rotinas de Cobrança Gateway
• Manual API Asaas