Escolha sua Integração

A escolha depende do nível de controle desejado, da estrutura técnica existente e de onde o comprador realizará o pagamento.

📘
Considere também o nível de controle desejado
Soluções mais prontas reduzem o esforço de desenvolvimento, enquanto integrações mais diretas oferecem maior flexibilidade e exigem mais responsabilidade técnica, monitoramento e manutenção.

API Direta

A API Direta é recomendada para empresas que já possuem um checkout próprio e desejam total controle sobre a experiência de pagamento.

Nesta modalidade, sua aplicação é responsável por coletar os dados do comprador e enviar as informações para a API da Cyclopay.

SmartForm

O SmartForm permite adicionar um formulário seguro de cartão diretamente em sua página sem a necessidade de desenvolver toda a captura dos dados de pagamento.

Os campos de cartão são fornecidos pela Cyclopay e integrados ao seu checkout.

Checkout e Link de Pagamento via API

O link de pagamento, utiliza nosso checkout personalizável como página de pagamento, e é hospedada pela Cyclopay.

Após criar uma cobrança, você recebe uma URL que pode ser compartilhada com o comprador.

Esse recurso é disponibilizado diretamente em nosso BackOffice, ou seja, não há necessidade de integração; a ferramenta é de pronto uso.

Qual devo escolher?

As três perguntas mais importantes

Queremos que o pagamento aconteça dentro da nossa própria interface ou em uma página hospedada?
Já temos estrutura técnica para coletar e tratar dados de pagamento com segurança?
Quanto precisamos personalizar regras, layout e comportamento do checkout?

📘
Recomendações:

API Direta se você já possui infraestrutura de checkout.

SmartForm se deseja adicionar pagamento por cartão em seu site rapidamente.

Checkout e Link de Pagamento quando desejar utilizar uma página hospedada pela Cyclopay. O checkout define a experiência de pagamento e é vinculado aos links gerados para cada cobrança

flowchart TD

    A["🚀 Escolhendo sua integração"] --> B{"Já possui um checkout próprio?"}

    B -->|Sim| C["💻 API Direta"]
    B -->|Não| D{"Onde deseja receber o pagamento?"}

    D -->|No meu site ou aplicação| E["🧩 SmartForm"]
    D -->|Em uma página hospedada pela Cyclopay| F["🔗 Checkout"]

    C --> C1["Controle total da experiência de pagamento"]
    E --> E1["Formulário seguro integrado ao seu site"]
    F --> F1["Link de pagamento pronto para compartilhar"]

Opção	Quando considerar	Esforço técnico	Controle da experiência	Responsabilidade principal
API direta	Quando o pagamento deve fazer parte de um fluxo próprio no site, aplicativo ou sistema.	Alto	Alto	Desenvolver a interface, integrar o backend, coletar os dados necessários e tratar os retornos da API.
SmartForm	Quando os campos de cartão precisam ser incorporados ao site sem que o estabelecimento desenvolva toda a captura segura dos dados..	Médio	Médio/alto	Integrar o componente, configurar sua exibição e utilizar os dados retornados no fluxo de pagamento
Checkout e Link de Pagamento	Quando é necessária uma página de pagamento hospedada, configurável e acessada por meio de um link.	Baixo/médio	Médio	Configurar o checkout, criar a cobrança via API ou BackOffice, compartilhar o link gerado e acompanhar o pagamento.