API Direta
Crie uma experiência de pagamento de propriedade do comerciante com APIs de servidor DEUNA.
Nesta página
Controle a interface e coordene pagamentos pelo seu backend.
Crie a jornada do cliente no seu aplicativo e use as APIs da DEUNA para operações de pagamento, usuário, cartão e orquestração.
- Interface
- Frontend e backend controlados pelo lojista
- Modelo de entrega
- APIs servidor a servidor com suporte no cliente quando necessário
- Ideal para
- Equipes que precisam de controle máximo do produto
Integre as soluções DEUNA Payment e Checkout em sua aplicação via Direct API/Headless.
Os serviços API DEUNA são organizados em torno do princípio REST.
Isso significa que os serviços:
- São orientados para recursos.
- Receba e retorne respostas JSON.
- Use códigos de resposta HTTP padrão.
- Autenticar com padrões REST
- Use os verbos REST padrão GET, POST, PATCH, FETCH e DELETE.
Autenticação#
DEUNA cria chaves API públicas e privadas para sua aplicação.
Use chaves de API para se autenticar como comerciante na API. As chaves APY são criadas durante a criação da sua conta Sandbox e também podem ser fornecidas por um DEUNA TPM. Você pode criar várias chaves de API associadas à mesma conta.
Os tokens JWT são usados para chamadas que criam pagamentos, armazenam cartões e operam com dados do usuário.
Idempotência#
As APIs DEUNA suportam idempotência, permitindo que você tente novamente solicitações à nossa API sem se preocupar em gerar acidentalmente a mesma operação duas vezes.
DEUNA salva o código de resposta e a carga útil da primeira solicitação para cada valor do idempotency key.
DEUNA salva o código de resposta e a carga útil da primeira solicitação para cada valor da chave de idempotência.
Chaves de idempotência são usadas para o verbo HTTP: POST.
Ambientes#
O ambiente API DEUNA possui dois ambientes independentes um do outro:
Ambiente de Teste
Sandbox é o ambiente usado para testes.
O ambiente sandbox contém as conexões com vários provedores de pagamento e fraude visando seus respectivos ambientes de teste.
Utilize o ambiente sandbox para realizar os testes com dados disponíveis para cada fornecedor
URL: https://api.sandbox.deuna.io
Produção
Produção é o ambiente usado para processar transações reais no ambiente de produção.
É altamente recomendável testar cada integração no ambiente sandbox antes de movê-la para produção.
URL: https://api.deuna.io
Coleção do Postman#
DEUNA tem a seguinte coleção pública do Postman para integrações e testes mais convenientes: Coleção DEUNA Carteiro.
Gerenciamento de usuários#
DEUNA permite a criação de usuários para melhor gestão e estruturação de todos os recursos e serviços:
- Crie usuários.
- Obtenha usuários.
- Exclua usuários.
- Associe cartões armazenados aos usuários.
- Associar pagamentos aos usuários.
- Associar endereços aos usuários.
Armazenar cartões#
DEUNA oferece funcionalidade de armazenamento de cartões para armazenar cartões previamente armazenados e proporcionar uma melhor experiência aos seus clientes.
A DEUNA gera um token único para cada cartão criado que pode ser armazenado sem qualquer risco.
Processar pagamentos#
Processe pagamentos de seus usuários através de uma integração única usando nosso mecanismo de pagamento e fraude que permite orquestrar pagamentos em tempo real.
Processe pagamentos com vários provedores de pagamentos e fraudes, mantendo a mesma estrutura de resposta e padronização de códigos de erro entre fornecedores.
3DS#
DEUNA suporta o fluxo 3DS em todas as suas integrações.
Webhooks#
DEUNA comunica atualizações sobre alterações no status do pedido via webhook.
Webhooks são recomendados para comunicar eventos assíncronos de métodos de pagamento. O resultado da aprovação ou rejeição é comunicado por meio desta norma.
Com novas tecnologias como o 3DS, até mesmo as transações com cartão se tornam assíncronas, e é importante ouvir os eventos do pedido assim que o usuário conclui a autenticação com seu banco e recebe o status final do pagamento.