Skip to main content
Este roteiro define os cenários de teste obrigatórios que o integrador deve executar em ambiente de testes (sandbox) antes de virar para produção. Para cada cenário há o resultado esperado e a evidência que deve ser anexada ao Formulário de Homologação. A equipe FastPay valida as evidências e libera a produção. Este documento não ensina a integrar — o passo a passo técnico está na referência da API. Aqui está apenas o que testar e o que comprovar.

​
Como usar

  1. Ative o modo de testes e use as chaves sk_test_ (ver Autenticação).
  2. Execute os cenários da(s) funcionalidade(s) que você integrou: Cobrança sem split, Cobrança com split, FastConnect (subcontas), Apple Pay e/ou Saques (payout).
  3. Para cada cenário, guarde: corpo da requisição, corpo da resposta, o ID gerado (cobrança, subconta ou saque) e, quando houver, o registro do webhook recebido e a resposta HTTP que seu endpoint devolveu.
  4. Preencha o Formulário de Homologação com as evidências e envie para a equipe FastPay.

​
Convenções de evidência

  • Requisição/resposta: JSON completo (pode omitir dados de cartão; a FastPay não precisa do PAN).
  • Webhook: print ou log mostrando o evento recebido e o status HTTP < 400 que seu endpoint respondeu.
  • Identificadores: sempre informe o id da cobrança/subconta/saque para rastreio.
  • Um cenário só é considerado testado com a evidência anexada — “funcionou” sem evidência não homologa.

​
A. Cobrança sem split (cartão de crédito + Pix)

Referências: Criar cobrança · Consultar cobranças · Estorno · Webhooks de cobrança
Autenticação obrigatória em todos os cenários. 3D Secure, quando aplicável ao seu perfil, é coberto no cenário AP/3DS da sua conta — ver 3DS.

​
B. Cobrança com split

Pré-requisito: os recebedores do split (merchantId) devem existir e pertencer ao seu grupo FastConnect. O split é enviado no campo split da cobrança, cada item com merchantId e percentage (0,01 a 100). Referências: Cálculo do split · Criar cobrança

​
C. FastConnect (subcontas)

Referências: FastConnect · Criar subconta · Enviar documentos · Chaves da subconta · Criar saque · Webhooks de conta
O valor do saque é em reais (decimal). Enviar em centavos gera um saque muito maior do que o pretendido.

​
D. Apple Pay

Pré-requisito: o certificado Apple Pay da empresa deve estar cadastrado e vinculado e o método habilitado (feito pela equipe FastPay). A cobrança Apple Pay é enviada como cartão de crédito acompanhada do objeto de carteira (wallet com o token do Apple Pay). Referências: Apple Pay · Criar cobrança

​
E. Saques (payout)

Aplica-se ao saque da própria conta. Pré-requisitos: transferências habilitadas e saldo disponível. O valor é sempre em reais (decimal). O saque de subconta (FastConnect) está no cenário FC-07. Referências: Criar saque · Listar saques · Webhooks de saque
A consulta individual do saque é restrita; acompanhe pela listagem. O webhook de saque é enviado no fluxo de subconta (FastConnect) — no saque da própria conta, acompanhe o status pela listagem.

​
Formulário de Homologação

Ao final, preencha o Formulário de Homologação de Integração (fornecido pela equipe FastPay), com uma linha por cenário deste roteiro, anexando as evidências correspondentes.
Critério de liberação para produção: todos os cenários obrigatórios das funcionalidades integradas com status Aprovado. Qualquer cenário Reprovado bloqueia a virada até correção e reenvio da evidência.