API e docs no domínio da marca: confiança de integrador
O desenvolvedor do seller não quer ler ApexPy. Quer api.suamarca, chave no painel dele e cURL com o nome da bandeira.
Seller técnico decide gateway pela documentação. Se o README abre com outro nome, você já perdeu o integrador — mesmo com taxa boa.
O que ele precisa ver no primeiro minuto
- Base URL no seu domínio.
- Chave pública e secreta por ambiente, no painel do seller.
- Webhook com HMAC, retentativa e log consultável.
- Exemplos em cURL, PHP, Node e Python.
- Nenhuma menção à ApexPy.
A faixa de documentação da landing é essa lista em cartão. Aqui é o porquê comercial: o dev é o comprador invisível da troca.
Idempotência e rate limit não são detalhe
Quem já integrou gateway frágil tem medo de cobrança duplicada. Idempotência por chave e limite por chave são o antídoto. Contingência de provedor sem isso vira double-charge na primeira retentativa.
Como a agência usa isso
No playbook de troca de gateway, o item 4 é este artigo. Mande o lead abrir `docs.apexpy.com.br` hoje e imagine o mesmo portal com a marca dele. O core é o mesmo. O nome na capa muda.