CaktoDevelopers
Primeiros Passos

Ambientes

Configuração de staging e produção para a Cakto Payments API.

Ambientes

Endpoints base

AmbienteBase URL
Staginghttps://api.scpay.com.br
Produçãohttps://api.cakto.com.br

Variáveis de ambiente recomendadas

# .env.local (Next.js / Node.js)

# Ambiente (true = staging, false = produção)
CAKTO_STAGING=true

# URLs e credenciais (servidor — NUNCA expor ao cliente)
CAKTO_BASE_URL=https://api.scpay.com.br
CAKTO_API_TOKEN=9944b09199c62bcf9418ad846dd0e4bbdfc6ee4b
CAKTO_MERCHANT_ID=42

# Públicas (prefixo NEXT_PUBLIC_ para Next.js — apenas dados não sensíveis)
NEXT_PUBLIC_CAKTO_BASE_URL=https://api.scpay.com.br
NEXT_PUBLIC_CAKTO_MERCHANT_ID=42
NEXT_PUBLIC_NETHONE_SCRIPT_URL=https://c.ns8.com/s/js/dftp-xxxx.min.js

Nunca misture staging e produção em um mesmo ambiente. Use a variável CAKTO_STAGING como chave única que controla todos os endpoints, incluindo os scripts 3DS.

Scripts 3DS por ambiente

Ambiente CaktoBP.MPI URL
Staging (api.scpay.com.br)https://mpisandbox.braspag.com.br/Scripts/BP.Mpi.3ds20.min.js
Produção (api.cakto.com.br)https://mpi.braspag.com.br/Scripts/BP.Mpi.3ds20.min.js

O script Cardinal (DDC) usa o mesmo URL em ambos os ambientes:

https://songbird.cardinalcommerce.com/edge/v1/songbird.js

Cartões de teste (staging)

Use estes cartões com o ambiente de staging (https://api.scpay.com.br):

NúmeroBandeiraResultado
4111111111111111VisaAprovado
5502093208576598MastercardAprovado
4000000000000002VisaRecusado (genérico)
4000000000000069VisaExpirado
4000000000000127VisaCVV incorreto

Use qualquer data de expiração futura e CVV de 3 dígitos para os cartões que aprovam.

Boas práticas de configuração

  1. Uma variável de ambiente controla o ambiente — não duas URLs hardcoded
  2. Credenciais diferentes para staging e produção
  3. Webhook URL diferente para cada ambiente (postbackUrl)
  4. Nunca commite arquivos .env no repositório

Autenticação

Token Authentication para todas as chamadas à Cakto Payments API.

Pagamentos

Visão geral dos fluxos de pagamento disponíveis na Cakto Payments API.

On this page

AmbientesEndpoints baseVariáveis de ambiente recomendadasScripts 3DS por ambienteCartões de teste (staging)Boas práticas de configuração