Dom Docs
Dom Pagamentos

Primeiros Passos

Guia

Atualizado em · 2 min de leitura

Recente

Crie sua primeira transação com a API Dom Pagamentos em minutos.

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)
  • Ambiente de testes (Sandbox) para os primeiros testes
1

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.

2

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.

3

Crie sua primeira transação

Use o endpoint `POST /transactions` com o método de pagamento desejado (cartão, Pix ou boleto).

4

Monitore o status

Consulte o status da transação 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.

Próximos passos

Esta página foi útil?