Primeiros Passos
Atualizado em · 2 min de leitura
RecenteCrie 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
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.
Crie sua primeira transação
Use o endpoint `POST /transactions` com o método de pagamento desejado (cartão, Pix ou boleto).
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
- Criar transação — referência completa dos parâmetros
- Configurar Webhooks — receba notificações de pagamento
- Testar em Sandbox — simule cenários de sucesso e falha