Pular para o conteúdo

Ambiente Stage

Teste cada fluxo no Stage. Sem mover dinheiro real.

O Stage espelha a produção: o mesmo contrato de API, os mesmos webhooks e o seu próprio Business Portal. Você constrói e testa contra o mesmo contrato que vai usar em produção. Só o dinheiro é simulado.

Solicitar acesso ao StageGuia de testes
  • Espelha a produção
  • Cartões de teste e simuladores
  • Coleção do Postman

Ambientes

Dois ambientes, uma integração

Troque de ambiente alterando a URL base e as credenciais que você carrega.

  • URL base da API

    Stage
    https://api.stage.localpayment.com
    Produção
    https://api.v3.localpayment.com

  • Business Portal

    Stage
    ui.stage.localpayment.com
    Produção
    ui.v3.localpayment.com

  • Dinheiro

    Stage
    Simulado: nenhum fundo real se move
    Produção
    Fundos reais em trilhos reais

  • Credenciais

    Stage
    Emitidas no início da parceria
    Produção
    Emitidas após os testes no Stage, a revisão de segurança e o KYB

  • Dados

    Stage
    Somente dados de teste fictícios
    Produção
    Dados reais de clientes, protegidos pelos seus controles e pelos nossos

  • Lista de IPs permitidos

    Stage
    Obrigatória
    Produção
    Obrigatória

As credenciais do Stage e da produção são diferentes. Guarde-as como segredos separados.

O que você pode testar

Ensaie o que você vai operar em produção

  • Pay-ins com cartão

    Aprovações, recusas, desafios 3D Secure e erros de processamento, cada um com seu número de cartão de teste.

  • Contas virtuais

    Crie contas e simule transferências recebidas para testar a identificação automática do pagamento, a conciliação e os webhooks.

  • Meios de pagamento locais

    Crie pay-ins com Pix e outros meios locais e confira QR Codes, instruções de pagamento e status pendentes.

  • Payouts

    Execute os cenários de teste documentados para ver cada status do fluxo de payouts.

  • Webhooks de ponta a ponta

    Aponte uma URL de notificações do Stage para o seu endpoint e verifique as assinaturas antes da produção.

  • Tratamento de falhas

    Reenvie um externalId para ver o 409 Conflict, deixe um token expirar e pratique retentativas com backoff.

Cartões de teste

Números de cartão para cada resultado

Use qualquer data de validade futura. CVC: quaisquer 3 dígitos (4 para Amex).

  • 4242 4242 4242 4242

    Resultado
    Aprovado
    Use para testar
    O caminho feliz: autorização, confirmação e webhook

  • 4000 0000 0000 0002

    Resultado
    Recusado
    Use para testar
    Mensagens de recusa e opções de retentativa no seu checkout

  • 4000 0025 0000 3155

    Resultado
    Desafio 3D Secure
    Use para testar
    A etapa de autenticação e o retorno ao seu fluxo

  • 4000 0000 0000 9995

    Resultado
    Erro de processamento
    Use para testar
    Tratamento de erros, logs e mensagens ao cliente

Somente para o Stage. A aceitação de cartões está disponível na Argentina, na Colômbia, no México e no Peru; o 3D Secure se aplica na Colômbia, no México e no Peru.

Simulador de contas virtuais

Simule uma transferência quando quiser

Não é preciso esperar uma transferência real: crie uma conta virtual no Stage, chame o simulador e acompanhe o pagamento simulado na identificação automática, nas mudanças de status e no processamento das suas notificações.

  • POST /api/simulate/va está disponível somente no Stage
  • Use-o para testar o processamento de webhooks VirtualAccount antes de entrar no ar
  • Ideal para testes automatizados de ponta a ponta no seu pipeline de CI
Guia de testes
# Somente no Stage. Corpos ilustrativos: veja o guia de testes para o contrato exato.

# 1) Crie uma conta virtual para um cliente de teste (México, CLABE)
curl -X POST https://api.stage.localpayment.com/api/virtual-account \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "3b9f6c1e-0000-4000-8000-000000000123",
    "country": "MEX",
    "currency": "MXN",
    "beneficiary": { "name": "Ana Torres", "document": { "type": "RFC", "id": "TOAA800101XXX" } }
  }'

# 2) Simule uma transferência recebida nessa conta
curl -X POST https://api.stage.localpayment.com/api/simulate/va \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "accountNumber": "646180000000004821",
    "amount": 1250.00,
    "currency": "MXN"
  }'

# 3) Seu endpoint de webhooks recebe uma notificação VirtualAccount

Postman

Importe a coleção e envie sua primeira requisição

A coleção do Postman da Localpayment vem com um arquivo de ambiente Stage, para você explorar a API antes de escrever uma linha de código.

  • Um arquivo de ambiente STAGE que direciona cada requisição ao Stage
  • Use junto com a referência da API para conferir o formato de requisições e respostas
  • Adicione suas credenciais do Stage localmente e nunca compartilhe um espaço de trabalho que as contenha
Baixar a coleção do Postman

Boas práticas

Teste como se fosse produção

  • Somente dados fictícios

    Use nomes e números de documento inventados. Nunca carregue dados reais de clientes ou de cartões no Stage.

  • Segredos separados

    Mantenha as credenciais do Stage e da produção separadas, cada uma no seu gerenciador de segredos.

  • Teste os caminhos difíceis

    Recusas, 3D Secure, tempo limite esgotado, duplicidades 409 e tokens expirados, não só aprovações.

  • Exercite as reentregas de webhooks

    Responda uma vez com um código diferente de 200 e confirme que seu receptor aplica a reentrega uma única vez.

  • Respeite a validade dos tokens

    Os tokens de acesso duram 5 minutos. Construa a lógica de renovação agora, não depois de entrar no ar.

  • Automatize seus testes

    Rode testes de ponta a ponta contra o Stage no seu CI usando o simulador de contas virtuais.

Como acessar

Como obter credenciais do Stage

  1. 01

    Conte sobre o seu projeto

    Compartilhe seu caso de uso, seus mercados e os volumes esperados pelo formulário de contato.

  2. 02

    Inicie a parceria

    As condições comerciais são acordadas e o credenciamento começa, incluindo uma revisão de compliance.

  3. 03

    Receba as credenciais do Stage

    Você recebe um usuário e uma senha de API para o Stage, além de acesso ao Business Portal do Stage.

  4. 04

    Cadastre seus IPs e construa

    Adicione os IPs dos seus servidores, importe a coleção do Postman e siga o guia rápido.

Perguntas frequentes sobre o Stage

O Stage movimenta dinheiro real?

Não. O Stage espelha o comportamento da produção com fundos simulados. Nada do que você faz lá chega a um banco, uma bandeira de cartão ou uma carteira real.

Posso usar dados reais de clientes no Stage?

Não. Use apenas nomes, números de documento e cartões fictícios. Dados pessoais ou de cartões reais nunca devem ser enviados a um ambiente de testes.

Qual é a diferença entre o Stage e a produção?

O contrato da API e os webhooks são os mesmos. Os pagamentos são simulados (as transferências para contas virtuais, por exemplo, vêm do simulador), então os tempos não refletem os trilhos reais.

Como passo para a produção?

Conclua os testes no Stage, a revisão de segurança e a verificação da empresa (KYB). Depois emitimos as credenciais de produção. O guia rápido traz o checklist completo para entrar no ar.

Com quem falo se algo não funcionar?

Escreva para support@localpayment.com, disponível 24/7, ou use o “Ask AI” na documentação para respostas rápidas.

Receba suas credenciais do Stage

Comece a conversa com nossa equipe. O acesso ao Stage é liberado quando a sua parceria começa.

Fale com vendasSeguir o guia rápido

Como podemos ajudar?

Baixe o seu exemplar

Deixe seus dados e receba a edição completa na hora.