API orientada a desenvolvedores
A Stone tem uma das APIs mais bem documentadas entre as adquirentes brasileiras, com exemplos de código, SDKs e ambientes bem separados. O desenvolvimento é mais previsível porque o comportamento da API é consistente.
Integrações / Gateways / Stone
Integração com a
Stone
para e-commerce
e marketplaces
Desenvolvimento de integração com a API da Stone para checkout transparente, split de pagamento em marketplaces, Pix e sistemas com fluxo financeiro personalizado.
Sobre a Stone
O gateway e sua API
A Stone é uma fintech com adquirência própria que tem se destacado pelo foco em desenvolvedores e pela qualidade da sua documentação técnica. A API REST da Stone é estruturada, com autenticação via token de acesso e comportamento consistente entre os ambientes de sandbox e produção.
O diferencial mais relevante da Stone para integrações complexas é o suporte nativo a split de pagamento. Em uma única transação é possível definir regras de divisão entre múltiplos recebedores — o que elimina a necessidade de transferências manuais em modelos de marketplace, plataformas com parceiros ou negócios com repasse automático de comissão.
Um ponto de atenção importante: a Stone trabalha com o conceito de merchant token gerado para cada estabelecimento, e o fluxo de autenticação precisa ser tratado corretamente para evitar problemas de credencial em produção. A separação entre os ambientes é clara, mas o onboarding de credenciais exige atenção ao processo da Stone.
O que a integração cobre Aspectos técnicos
Aspectos técnicos
do desenvolvimento
Split de pagamento
A API da Stone suporta divisão automática de valores entre múltiplos recebedores em uma mesma transação — essencial para marketplaces, plataformas multi-vendedor e modelos com repasse de comissão.
Pix integrado ao checkout
A integração inclui geração de QR Code dinâmico para Pix, exibição no checkout e recebimento de confirmação via webhook — tudo dentro do mesmo fluxo de pagamento.
Sandbox completo e separado
O ambiente de testes da Stone é bem estruturado, com credenciais próprias de sandbox e comportamentos configuráveis para simular aprovação, recusa, timeout e webhooks antes de qualquer transação real.
Webhooks confiáveis
A Stone notifica seu sistema sobre mudanças de status via webhook com mecanismo de autenticação. A integração inclui o endpoint receptor com verificação da origem e processamento idempotente das notificações.
Tratamento de erros estruturado
A API da Stone retorna erros com código e mensagem padronizados. A integração mapeia cada cenário — recusa, dados inválidos, limite excedido — com tratamento adequado e log para monitoramento.
Integração via API Por que não usar
Por que não usar
um plugin pronto
Quando um plugin é suficiente
Para casos de uso simples em WooCommerce, há plugins de terceiros para a Stone. Se o fluxo é padrão e não há split ou lógica customizada, um plugin pode resolver.
Quando a integração direta é necessária
- Você tem um marketplace e precisa de split automático
- Sua plataforma não tem módulo oficial ou atualizado para a Stone
- Você opera com sistema próprio ou ERP sem suporte a plugins
- Precisa de lógica de repasse automático após confirmação do pagamento
- O fluxo de pagamento tem regras de negócio que um plugin não suporta
- Você quer logs detalhados e controle sobre o tratamento de erros
- Está construindo uma fintech ou produto financeiro
A Stone tem posicionamento explícito para desenvolvedores. A API é projetada para ser integrada diretamente, não através de plugins intermediários.
Conversar sobre o projeto Cenários de uso Quando a integração
Split de pagamento API para desenvolvedores Módulo customizado Backend customizado
Quando a integração
com a Stone faz sentido
Marketplace com múltiplos vendedores
Você tem uma plataforma onde múltiplos vendedores vendem ao mesmo tempo e precisa dividir automaticamente o valor recebido entre eles — descontando a comissão da plataforma. O split da Stone trata isso na própria transação, sem precisar fazer transferências manuais depois.
Fintech ou plataforma financeira
Você está construindo um produto financeiro que precisa de uma API confiável, bem documentada e com suporte a fluxos avançados. A Stone tem posicionamento claro para esse tipo de integração, com SDKs e exemplos que aceleram o desenvolvimento.
E-commerce sem plugin ativo para a Stone
Sua plataforma não tem módulo oficial para a Stone ou o módulo existente não é mantido. O desenvolvimento cria essa conexão via API diretamente, com checkout transparente e suporte aos meios de pagamento necessários.
Sistema próprio com fluxo financeiro complexo
Seu sistema tem regras de negócio específicas — aprovação em etapas, repasse automático, cobrança condicional. A integração direta com a API da Stone permite implementar essa lógica sem as limitações de um plugin genérico.
Processo
Como o projeto funciona
Análise do ambiente
Entender a plataforma, o backend e se há necessidade de split, webhook ou integração com sistemas externos.
Levantamento de requisitos
Quais métodos de pagamento, se há múltiplos recebedores, como o split deve funcionar e quais regras de negócio precisam ser implementadas.
Configuração do sandbox
Credenciais de teste da Stone e leitura da documentação para entender os endpoints, formatos e comportamento esperado da API.
Desenvolvimento
Construção dos endpoints de cobrança, split, consulta, cancelamento e webhook com tratamento de erros e log.
Testes de homologação
Simulação de todos os cenários no sandbox: aprovação, recusa, Pix, split entre recebedores, cancelamento e webhook.
Publicação em produção
Migração das credenciais de produção, deploy e monitoramento das primeiras transações reais.
Plataformas e ambientes
Marketplace próprio
Split automático entre vendedores na transação
WooCommerce
Módulo customizado com checkout transparente
Sistema próprio
Integração via API no backend com regras de repasse
ERP
Cobrança automatizada com divisão de recebíveis
Fintech
API integrada ao core financeiro do produto
Aplicativo mobile
Backend intermediário seguro sem exposição de credenciais
Não viu sua plataforma? Fale sobre o projeto — o processo começa pelo entendimento do ambiente atual.
Perguntas frequentes
O que é o gateway Stone e como funciona sua API?
A Stone é uma fintech brasileira com adquirência própria e API REST bem documentada voltada para desenvolvedores. Permite processar cartão de crédito, débito, Pix e boleto. A autenticação é feita via chave de acesso gerada no ambiente Stone.
A Stone tem sandbox para testes?
Sim. A Stone disponibiliza ambiente sandbox completo com credenciais próprias para simular transações antes de ir para produção. O ambiente de testes é separado do de produção e permite testar aprovações, recusas e webhooks.
A Stone suporta split de pagamento para marketplaces?
Sim. A API da Stone suporta split de pagamento, permitindo dividir automaticamente o valor de uma transação entre múltiplos recebedores. Isso é especialmente relevante para marketplaces, plataformas multi-vendedor e modelos com comissão.
A Stone é indicada para fintechs?
Sim. A Stone tem forte posicionamento para desenvolvedores e fintechs, com documentação técnica detalhada, suporte a split e uma API projetada para integrações customizadas.
Como funcionam os webhooks da Stone?
A Stone envia notificações para um endpoint configurado no seu sistema quando o status de uma transação muda. A integração inclui o desenvolvimento desse endpoint com validação da autenticidade da chamada e atualização automática do sistema.
É possível integrar a Stone com WooCommerce ou OpenCart?
Sim. Para essas plataformas é possível desenvolver um módulo customizado que se comunica diretamente com a API da Stone. Dependendo do volume e do fluxo, a integração direta tende a ser mais estável do que um plugin de terceiro.
A Stone tem suporte a Pix?
Sim. A API da Stone suporta Pix com geração de QR Code e confirmação via webhook. O fluxo de Pix pode ser integrado junto com os demais métodos de pagamento num mesmo checkout.
Quanto tempo leva e quanto custa?
Depende do escopo: plataforma, métodos de pagamento, se há split, webhook e integração com outros sistemas. O melhor caminho é conversar sobre o projeto para um levantamento preciso.
Próximo passo Precisa integrar a Stone
Precisa integrar a Stone
ao seu sistema?
O primeiro passo é entender o cenário atual — plataforma, backend, se há split e quais meios de pagamento fazem sentido para o seu negócio. Sem compromisso.
Solicitar orçamento
Atendimento para todo o Brasil · Projetos remotos