Escolha entre Pix Automático e Assinaturas

Assinaturas e Pix Automático atendem cobranças recorrentes, mas resolvem necessidades diferentes.

A principal diferença está na forma de pagamento: Assinaturas geram cobranças recorrentes; Pix Automático realiza débitos recorrentes via Pix após autorização do pagador.

Compare os recursos

Como escolher

%%{init: {"flowchart": {"nodeSpacing": 28,"rankSpacing": 32,"diagramPadding": 8,"padding": 10}}}%%
flowchart TD
    A["Definir o modelo de recorrência"] --> B{"Precisa de débito recorrente via Pix?"}

    B --> BSim(("Sim"))
    B --> BNao(("Não"))

    BSim --> C["Utilizar Pix Automático"]
    BNao --> D["Utilizar Assinaturas"]

    C --> E["Criar a autorização"]
    D --> F["Criar a assinatura"]

    classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,stroke-width:3px,font-size:17px
    classDef decisao fill:#FEF3C7,stroke:#D97706,color:#78350F,stroke-width:3px,font-size:17px
    classDef validacao fill:#E0F2FE,stroke:#0284C7,color:#0C4A6E,stroke-width:2px,font-size:17px
    classDef sucesso fill:#DCFCE7,stroke:#16A34A,color:#14532D,stroke-width:3px,font-size:17px

    classDef respostaSim fill:#22C55E,stroke:#15803D,color:#FFFFFF,stroke-width:3px,font-size:16px
    classDef respostaNao fill:#EF4444,stroke:#B91C1C,color:#FFFFFF,stroke-width:3px,font-size:16px

    class A inicio
    class B decisao
    class C,D validacao
    class E,F sucesso

    class BSim respostaSim
    class BNao respostaNao

    linkStyle default stroke:#94A3B8,stroke-width:2px
    linkStyle 1 stroke:#22C55E,stroke-width:4px
    linkStyle 2 stroke:#EF4444,stroke-width:4px

Assinaturas

Utilize Assinaturas quando sua operação precisar gerar cobranças recorrentes com boleto, Pix ou cartão de crédito.

Após criar a assinatura, o Asaas gera as próximas cobranças conforme a periodicidade configurada.

No cartão de crédito, o pagamento pode ser processado automaticamente nos vencimentos. Em boleto ou Pix, o Asaas gera a cobrança e o pagador realiza o pagamento.

As cobranças pertencentes à assinatura possuem ciclo de vida próprio e devem ser acompanhadas pelos Eventos para cobranças. Alterações na própria recorrência podem ser acompanhadas pelos Eventos para assinaturas.

Conheça as Assinaturas.

Pix Automático

Utilize Pix Automático quando sua operação precisar realizar débitos recorrentes via Pix após autorização prévia do pagador.

Na Jornada 3, o QR Code inicial reúne o primeiro pagamento e a autorização para os próximos ciclos. Depois da ativação, a autorização passa para ACTIVE.

A criação das cobranças futuras depende de paymentCreationMode:

MANUAL é o modo padrão.

Quando paymentCreationMode = SUBSCRIPTION, o campo value deve ser informado na autorização.

Conheça o Pix Automático.

Como o valor é controlado

Assinaturas

O valor é configurado na assinatura.

Quando necessário, a assinatura pode ser atualizada para alterar as próximas cobranças. Alterações suportadas também podem ser aplicadas às cobranças pendentes com updatePendingPayments.

Consulte o endpoint Atualizar assinatura existente.

Pix Automático

O comportamento depende da autorização.

Quando value é informado, as cobranças vinculadas devem respeitar o valor fixo autorizado.

No modo MANUAL, autorizações sem valor fixo permitem que a integração informe o valor de cada cobrança conforme as condições da autorização.

No modo SUBSCRIPTION, value é obrigatório.

Consulte o endpoint Criar uma autorização.

Acompanhe cada fluxo por Webhook

Nos dois modelos, prefira Webhooks para manter sua aplicação sincronizada e evite consultas frequentes apenas para verificar mudanças de estado.

Para Assinaturas, acompanhe:

• Eventos para assinaturas
• Eventos para cobranças

Para Pix Automático, acompanhe autorizações, instruções de pagamento e cobranças pelos Fluxos de Webhook do Pix Automático.

Próximos passos

• Crie uma assinatura
• Crie uma assinatura com cartão de crédito
• Acompanhe os eventos de assinaturas
• Conheça o Pix Automático
• Implemente o Pix Automático
• Acompanhe os Fluxos de Webhook do Pix Automático