Primeiros Passos | Dom Docs

Este guia mostra como autenticar e criar sua primeira transação usando a API Dom Pagamentos.

[!NOTE] Você vai precisar das suas credenciais de acesso. Se ainda não tem, entre em contato com o suporte Dom.

Antes de começar

Conta ativa na Dom Pagamentos
Chave de API (disponível no painel em Configurações → API)
Use o ambiente Sandbox para os primeiros testes — sem cobranças reais

Configure sua chave de API

Acesse o painel Dom Pagamentos, vá em **Configurações → API** e copie sua chave. Use-a no header `Authorization: Bearer <sua-chave>` em todas as requisições.

Faça uma requisição de teste

Antes de criar uma transação real, valide que suas credenciais estão corretas chamando qualquer endpoint GET. Um retorno `200` confirma que a autenticação está funcionando.

Crie sua primeira transação

Use o endpoint `POST /transactions` com o método de pagamento desejado (cartão, Pix ou boleto). O campo `amount` é sempre em centavos.

Verifique a resposta

A API retorna um objeto `order` com o `id` da transação e o `status`. Para cartão, o status já vem como `paid` ou `refused`. Para Pix e boleto, vem como `pending` até o pagamento ser confirmado.

Monitore o status

Consulte o status com `GET /transactions/{id}` ou configure um webhook para receber atualizações automaticamente.

Exemplo completo

curl --request POST \
  --url "{apiUrl}/transactions" \
  --header "Authorization: Bearer {token}" \
  --header "Content-Type: application/json" \
  --data '{
    "amount": 10000,
    "payment_method": "credit_card",
    "card": {
      "number": "4111111111111111",
      "holder_name": "João Silva",
      "exp_month": 12,
      "exp_year": 2028,
      "cvv": "123"
    },
    "customer": {
      "name": "João Silva",
      "email": "joao@exemplo.com",
      "document": "11144477735"
    }
  }'

[!TIP] O campo amount é sempre em centavos. R$ 100,00 = 10000.

Exemplo de resposta

json

{
  "order": {
    "id": "txn_abc123",
    "status": "paid",
    "amount": 10000,
    "payment_method": "credit_card",
    "created_at": "2026-03-27T10:00:00Z"
  }
}

Erros comuns

Código	Causa	Solução
`401 Unauthorized`	Chave de API inválida ou ausente	Verifique o header `Authorization: Bearer <chave>`
`422 Unprocessable Entity`	Parâmetros inválidos ou ausentes	Revise os campos obrigatórios (`amount`, `payment_method`, `customer`)
`400 Bad Request`	Cartão recusado ou dados incorretos	Verifique os dados do cartão ou use um cartão de teste válido

Próximos passos

Testar em Sandbox — simule cenários de sucesso e falha sem cobranças reais
Integrar o Checkout — fluxo completo com cartão, Pix e boleto
Criar transação — referência completa dos parâmetros
Configurar Webhooks — receba notificações de pagamento