Fundamentos de integração da API

Configure estes aspectos compartilhados antes de integrar um recurso da API da DEUNA. As mesmas regras de ambiente, rede, repetição e tempo limite se aplicam a pedidos, pagamentos, usuários, links de pagamento e assinaturas.

AmbientesPerguntar à Athia sobre isto#

Os ambientes de teste e produção são isolados e utilizam credenciais, dados, conexões com provedores e estado de pagamento diferentes.

Veja Autenticação e ambientes para conhecer os tipos de credencial, a rotação e os exemplos de solicitações.

Coleção do PostmanPerguntar à Athia sobre isto#

Use a coleção do Postman da DEUNA para explorar solicitações antes de desenvolver um cliente.

Abrir a coleção da DEUNA no Postman

1. Entre no Postman e crie um fork da coleção no seu workspace.
2. Selecione o ambiente de sandbox ou produção.
3. Configure merchant_id, public_api_keye private_api_key com os valores desse ambiente.
4. Comece por uma operação do catálogo de endpoints.

Endereços IPPerguntar à Athia sobre isto#

Prefira a lista de domínios permitidos, se a sua política de rede o suportar. Se um provedor de pagamento ou fraude exigir a listagem de endereços IP, utilize os endereços abaixo.

Códigos de respostaPerguntar à Athia sobre isto#

Operações bem-sucedidas retornam uma resposta 2xx . Uma resposta 4xx significa que autenticação, permissões, dados ou estado do recurso precisam mudar. Uma resposta 5xx é uma falha temporária da DEUNA ou do provedor e só deve ser repetida quando for seguro repetir a operação.

Use a referência de respostas e códigos de erro para identificar a causa, a política de repetição e a ação corretiva.

Solicitações idempotentesPerguntar à Athia sobre isto#

Envie uma X-Idempotency-Key para cada operação suportada que cria ou altera o estado do pagamento. Use a mesma chave e um corpo de solicitação idêntico byte a byte ao tentar novamente após uma falha de rede ou tempo limite do cliente. Use uma nova chave para uma nova tentativa de negócio.

X-Api-Key: YOUR_PRIVATE_API_KEY
X-Store-Code: STORE_CODE
X-Idempotency-Key: order_1042-attempt_1
Content-Type: application/json

As respostas bem-sucedidas são armazenadas por padrão por 24 horas. Leia Solicitações idempotentes Para os endpoints suportados, retenção de respostas de erro, cabeçalhos de replicação, conflitos e verificação no ambiente de teste.

Tempos limite do clientePerguntar à Athia sobre isto#

Um tempo limite do cliente significa que ele parou de esperar; isso não prova que o pagamento falhou. O processamento pode continuar por verificações de fraude, roteamento e provedor depois da desconexão.

Quando uma solicitação de pagamento expirar:

1. Mantenha o fulfillment bloqueado e marque a tentativa como pendente de conciliação no seu sistema.
2. Preserve o ID do pedido, o corpo e a chave de idempotência original.
3. Repita apenas quando a operação for elegível, com a mesma chave e corpo idêntico.
4. Reconcilie o estado final através do método suportado de processamento assíncrono e uma pesquisa de ordem apropriada no catálogo de endpoints.
5. Mostre o resultado conciliado ao comprador e resolva qualquer cancelamento ou reembolso necessário antes do fulfillment.