Pular para o conteúdo principal
Todos os sistemas operacionaisNovidadesv1
Entrar
DEUNA API

Referência de API

Escolha a operação da API, o modelo de autorização e o chamador corretos para cada fluxo de integração da DEUNA.

Última atualização: October 2, 2026Coleção do Postman
Nesta página

A referência da API da DEUNA abrange as operações de backend do lojista e de aplicativos do cliente publicadas na documentação anterior. Comece pelo chamador, não apenas pelo nome do recurso, pois o modelo de autorização compatível muda conforme a superfície. As outras rotas do API Gateway são intencionalmente excluídas desta referência.

Use a navegação da Referência da API para explorar as operações publicadas por área de produto e recurso.

Exemplos de solicitações de pedidos e pagamentosCopie solicitações completas do Purchase V2 e de criação opcional de pedidos por setor.AutenticaçãoEscolha a credencial e o modelo de autorização corretos para cada solicitante.Criar pagamentoRevise o contrato de pagamento completo e a interface interativa de solicitação.API de TemasCrie e gerencie configurações reutilizáveis de temas para Checkout e Widget.

URLs base#

Use o URL base do sandbox durante o desenvolvimento. Mude para a produção somente após receber as credenciais de produção e concluir a certificação.

Sandbox
https://api.sandbox.deuna.io
Produção
https://api.deuna.io

Selecione a superfície da API#

SuperfícieChamador pretendidoAutorizaçãoUtilize-o para
Backend do comerciante · comunicação entre servidoresInfraestrutura de comerciante confiávelChave API privada em X-Api-Key; X-Store-Code e cabeçalhos idempotentes, quando necessárioPedidos, compras, capturas, reembolsos, cancelamentos e consultas operacionais
Aplicativo do cliente · comunicação entre servidor e usuárioAplicativo web ou móvel do comerciante em nome de um clienteContexto de aplicação público mais usuário Authorization: Bearer … Após o login; nunca inclua uma chave privadaLogin opcional, perfis e endereços reutilizáveis e cartões armazenados

Autenticação#

Backend do comerciante

Envie a chave API privada em X-Api-Key, não no cabeçalho Bearer. Mantenha-a na infraestrutura do servidor confiável.

Cabeçalhos de solicitação do servidor para servidorHTTP
X-Api-Key: YOUR_PRIVATE_API_KEY
X-Store-Code: STORE_CODE
X-Idempotency-Key: order_1042-attempt_1
Content-Type: application/json

Cliente autenticado

Envie o token de acesso do usuário no cabeçalho Bearer. Algumas operações de pedidos e carteiras também exigem a chave do aplicativo do lojista ou o contexto da loja; a página de cada operação lista sua autorização e os cabeçalhos encaminhados.

Cabeçalhos de requisição do usuário para o servidorHTTP
Authorization: Bearer USER_ACCESS_TOKEN
X-Api-Key: APPLICATION_API_KEY
X-Store-Code: STORE_CODE
Content-Type: application/json

Veja Autenticação Para gerenciamento de credenciais, tempo de vida dos tokens e rotação.

Operações do backend do comerciante#

POST
/merchants/orders
Criar um pedido e obter o token do pedido
GET
/merchants/orders/{order_token}
Recuperar o pedido atual e o estado do pagamento
GET
/merchants/orders/{order_token}/payments-methods
Obter os métodos de pagamento disponíveis para o pedido
POST
/v2/merchants/orders/purchase
Criar pagamento
POST
/v2/merchants/orders/{order_token}/capture
Capturar um pagamento autorizado
POST
/v2/merchants/orders/{order_token}/refund
Criar um reembolso total ou parcial
GET
/merchants/checkout/themes
Liste e gerencie temas de Checkout do lojista

Operações do aplicativo do cliente#

POST
/users/request-code
Solicitar um código de login único
POST
/users/login
Trocar um OTP por um token de usuário
GET
/users/me
Ler o perfil do usuário autenticado
GET
/users/{user_id}/cards
Listar as cartões armazenados para o usuário autenticado
PATCH
/users/{user_id}/cards/{card_id}/set-as-default
Definir ou remover o cartão padrão do usuário autenticado

Respostas e erros#

2xxA solicitação foi bem-sucedida.
4xxAutenticação, permissões, estado ou dados de solicitação devem mudar. Inspecione o código de erro retornado.
5xxDEUNA ou um provedor falhou. Tente novamente somente quando a operação for idempotente, usando a mesma chave de idempotência.

Navegue pela lista completa em Códigos de erro.

Controle de versão de caminho#

Use cada caminho exatamente como publicado. O API Gateway frequentemente expõe rotas canônicas sem um interno /api/v1 prefixo. Um segmento de versão como /v2 está incluído apenas quando faz parte da via pública mostrada no catálogo. As alterações compatíveis com versões anteriores estão listadas no Registro de alterações.