Introdução

O FeitPay é uma API de gateway de pagamentos multi-tenant para lojistas: lojas de e-commerce, produtos SaaS, negócios de API e plataformas. Você cria intenções de pagamento (ou faturas e links de pagamento), envia os clientes para um checkout hospedado e recebe webhooks assinados à medida que o pagamento avança por uma máquina de estados rigorosamente definida. As equipes financeiras fazem a conciliação com base nas evidências do processador, em relatórios e em uma linha do tempo append-only.

Ativação da conta

Toda chave de API é uma chave live e todo pagamento é real. Os pagamentos são ativados após a verificação e aprovação da sua conta: você se cadastra, configura sua organização e envia a verificação da sua empresa, o FeitPay a revisa, e as chaves de API live, os pagamentos e os saques ficam disponíveis quando sua conta for ativada.

A ativação é decidida pelo FeitPay. Além de uma verificação da empresa aprovada, ela depende dos próprios requisitos de liberação da plataforma, incluindo as autorizações descritas em Situação regulatória; portanto, uma verificação aprovada não ativa uma conta por si só.

Recurso	Status
Cadastro, verificação de e-mail, organizações, lojas, convites de equipe	Disponível
Verificação da empresa (solicitação de lojista KYB)	Disponível — revisada manualmente pelos operadores do FeitPay; enviar não é uma aprovação
Chamados de suporte	Disponível
Endpoints de webhook	Podem ser cadastrados. Os endpoints pertencem a um ambiente e os eventos live vão apenas para endpoints live, então cadastre o seu quando a sua conta for ativada
Chaves de API live (gp_live_…)	Disponíveis quando sua conta for ativada; antes disso são recusadas com live_keys_disabled (conta ainda não ativada)
Intenções de pagamento, checkout hospedado, faturas e links de pagamento	Quando a sua conta for ativada
Saldos em custódia e saques	Quando a sua conta for ativada; os saques são ativados separadamente
PIX, cartões, SEPA	Não disponíveis — exigem parceiros licenciados; nenhum está contratado

Enquanto a sua conta não estiver ativada, requisições a recursos live falham com feature_unavailable_error; veja Erros.

Custódia

Os pagamentos live são em custódia. Eles são processados pela própria conta Bitcart da plataforma:

• o cliente paga para uma carteira da loja Bitcart da plataforma, não para uma carteira sua; o checkout abre uma fatura Bitcart por intenção, e apenas o status complete da Bitcart torna uma intenção confirmed;
• o valor recebido é então creditado ao saldo em custódia da sua organização: o FeitPay mantém os fundos nas carteiras da plataforma em seu nome e registra o que deve a você em um razão append-only (GET /v1/balances). Pagamentos parciais ou atrasados só são creditados depois que um operador os verifica;
• você retira os fundos por meio de saques para endereços da lista de permitidos, no mesmo ativo (sem conversão). Por padrão, um segundo membro da sua organização aprova cada saque, um operador do FeitPay sempre o revisa e a Bitcart o envia a partir da carteira quente da plataforma.

As contas só são ativadas para pagamentos live depois que cada requisito de liberação (release gate) é aprovado por dois operadores — incluindo o requisito legal custody_authorisation, porque manter e transferir criptoativos de clientes é uma atividade regulada na maioria das jurisdições. O FeitPay não tem nenhuma autorização desse tipo e não declara ter.

Além disso:

• As taxas da plataforma são cobradas do lojista separadamente (fatura mensal ou assinatura). Elas nunca são descontadas em silêncio dos pagamentos dos clientes.
• As taxas de rede dos pagamentos recebidos são pagas pelo remetente e não fazem parte do valor devido.
• Não existe chargeback como nos cartões. Reembolsos nunca são automáticos: você mesmo devolve os fundos, por exemplo com um saque para um endereço da lista de permitidos informado pelo cliente.

A custódia não é, por si só, uma isenção regulatória — é o contrário. Veja a Situação regulatória.

Como as peças se encaixam

1. Seu servidor cria uma intenção de pagamento com uma chave de API live e uma Idempotency-Key.
2. O cliente abre a URL do checkout hospedado (uma URL de capacidade impossível de adivinhar e de curta duração — sem nenhuma chave envolvida). O checkout abre uma fatura na conta Bitcart da plataforma e mostra, para cada ativo aceito, um endereço e o valor exato a enviar.
3. O processador informa o status da fatura. O FeitPay nunca confia no corpo de um callback: ele busca a fatura de novo na Bitcart, mapeia o status dela para a máquina de estados central e, quando a fatura é concluída, credita o valor recebido ao seu saldo em custódia.
4. Webhooks notificam o seu endpoint; você só entrega quando a intenção está fulfillable, confirmando com um GET antes de qualquer ação irreversível.
5. A conciliação compara as evidências do processador, os valores esperados, os créditos, os saques e a entrega dos webhooks, e aponta divergências.

Convenções que você verá em todo lugar

• A API fica em https://api.feitpay.com/v1; o painel em https://app.feitpay.com; os checkouts hospedados em https://checkout.feitpay.com.
• JSON com campos em snake_case; timestamps em UTC no formato ISO-8601 (2026-10-20T12:00:00Z).
• Os valores são strings decimais ("59.90"), nunca números de ponto flutuante. Valores em cripto também têm uma string inteira *_base_units ("99834" satoshis).
• Os IDs são strings opacas com prefixo: pi_ intenções de pagamento, cs_ sessões de checkout, inv_ faturas, whe_ endpoints de webhook, evt_ eventos, req_ ids de requisição.
• Toda resposta tem um cabeçalho Request-Id. Informe-o ao entrar em contato com o suporte.
• Todo objeto de lojista tem livemode. Os pagamentos nesta plataforma são sempre live (livemode: true).