Testando em Sandbox

O ambiente Sandbox permite testar toda a integração sem movimentar dinheiro real. Use-o sempre antes de ir para produção.

[!WARNING] O Sandbox utiliza uma URL base diferente da produção. Certifique-se de configurar {apiUrl} corretamente em cada ambiente.

Ambiente	URL Base
Sandbox	`https://hml-apiv3.dompagamentos.com.br/checkout/sandbox`
Produção	`https://apiv3.dompagamentos.com.br/checkout/production`

Cartão de crédito

Use os cartões abaixo para simular aprovações e recusas:

Número	Bandeira	Status retornado	Descrição
`4111 1111 1111 1111`	Visa	`paid`	Transação aprovada
`4012 8888 8888 1881`	Visa	`not_authorized`	Recusada pelo banco emissor

Para qualquer número de cartão válido não listado acima, a transação será aprovada com status paid. Use CVV 123 e qualquer data de expiração futura.

Pix

Crie uma transação com `payment_method: "pix"`

A API retorna um campo `pix_content` com uma URL de simulação.

Acesse a URL do `pix_content` no browser

Isso confirma o pagamento instantaneamente no sandbox.

O status da transação muda para `paid`

Seu webhook de `transaction.paid` será disparado normalmente.

Exemplo de response:

json

{
  "id": "txn_abc123",
  "status": "pending",
  "payment_method": "pix",
  "pix_content": "https://sandbox.dompagamentos.com.br/pix/pay/txn_abc123",
  "expires_at": "2026-03-27T16:00:00Z"
}

Boleto

Para simular o pagamento de um boleto, chame o endpoint dedicado do sandbox:

curl --request POST \
  --url "{apiUrl}/pay-boleto/{id}" \
  --header "Authorization: Bearer {token}" \
  --header "Content-Type: application/json" \
  --data '{
    "value": 100.00,
    "date": "2026-03-27T10:00:00Z"
  }'

Cartões 3DS

Para testar o fluxo de autenticação 3D Secure:

Cartão	Fluxo	Número	CVV	Vencimento
Mastercard	Challenge com sucesso	`5483 9281 6457 4623`	`123`	`11/25`
Mastercard	Challenge não autorizado	`5361 9568 0611 7557`	`123`	`11/25`

Subcontas

Use esses CNPJs para testar diferentes status de subconta:

CNPJ	Status retornado
`21111111111111`	`pending`
`31111111111111`	`rejected`

Próximos passos

Primeiros Passos — crie sua primeira transação
Integrando o Checkout — fluxo completo de pagamento
Autenticação 3DS — teste o fluxo de desafio 3DS