Processar o pagamento do pedido

Utilize esta operação do backend do comerciante para processar um token de pedido existente ou um pedido fornecido na solicitação. A DEUNA aplica as conexões de pagamento, roteamento, avaliação de risco e comportamento de captura configurados para o comerciante.

Cabeçalhos#

X-Api-KeystringObrigatório

Chave da aplicação do comerciante privada, validada pelo Gateway API.

Exemplo YOUR_PRIVATE_API_KEY

AuthorizationstringOpcional

Contexto autenticado opcional para métodos de pagamento e instrumentos armazenados específicos do cliente.

Exemplo Bearer USER_ACCESS_TOKEN

X-Store-CodestringOpcional

Armazene o contexto quando o comerciante possui configurações específicas da loja.

Exemplo principal

Content-TypestringObrigatório

Deve ser application/json.

Parâmetros de caminho#

Este endpoint não possui parâmetros de caminho.

Solicitar corpo#

order_tokenstringOpcional

Token de um pedido existente. Forneça este campo ou um ordem objeto que DEUNA pode criar.

orderobjectOpcional

Detalhes do pedido em linha quando o pagamento deve criar e processar o pedido em uma solicitação.

payer_infoobjectObrigatório

Identidade do cliente. A API valida isso payer_info.email está presente.

Mostrar atributos filhos

payer_info.emailstringObrigatório

E-mail do cliente usado para identificar o pagador.

payer_info.external_user_idstringOpcional

Identificador do cliente no sistema do comerciante.

payment_sourceobjectObrigatório

Instrumento e dados de conexão utilizados para processar o pagamento.

Mostrar atributos filhos

payment_source.method_typestringObrigatório

Tipo de método de pagamento, como credit_card ou uma carteira suportada.

payment_source.payment_methodstringOpcional

Token produzido por uma integração de cliente DEUNA.

payment_source.payment_method_idstringOpcional

Identificador do processador de pagamentos do comerciante, quando necessário.

payment_source.card_infoobjectOpcional

Detalhes do cartão tokenizados ou em conformidade com o PCI, para transações com cartão.

anti_fraud_infoobjectOpcional

Informações do cliente, dispositivo, navegador e contexto de risco, consumidas pelos serviços de prevenção de fraudes configurados.

callback_urlsobjectOpcional

Destinos de redirecionamento do cliente para estados de sucesso, pendente, rejeição, cancelamento ou falha.

specific_fieldsobjectOpcional

Campos específicos do provedor ou método de pagamento exigidos pela conexão selecionada.

subscriptionobjectOpcional

Contexto de assinatura quando a compra cria ou renova uma assinatura suportada.

Inicie com um pedido completo da indústria.#

O order O campo acima aceita o mesmo contexto de negócios modelado pela API de Pedidos. Para uma recuperação e fluxo de repetição mais claros, crie o pedido primeiro, mantenha suas order_token, e envie o token nesta solicitação.

QSRMenu, modificadores, entrega, programação e instruções.Companhias aéreasPNR, passageiro, bilhete, itinerário, tarifa, impostos e serviços adicionais.CinemaTela, local, assentos, entrega de bilhetes e serviços de alimentação.BancosPagamento de conta, produto, canal e contexto de extrato.VarejoProdutos, variantes, descontos, envio e entrega.

Resposta#

Retorna a ordem processada, incluindo seu order_token, tipo de ordem, status resultante, informações de pagamento e informações de assinatura, quando aplicável. Considere o estado retornado como autoritativo e continue o rastreamento assíncrono através de webhooks do comerciante.

Códigos de status

200O pagamento da ordem foi processado. Verifique a ordem e o status de pagamento retornados para determinar o resultado.

400A solicitação é inválida ou carece de dados necessários do pagador ou fonte de pagamento.

401A chave API privada ou o contexto de autorização do cliente são inválidos.

409A operação conflita com o estado atual da ordem ou com uma solicitação idempotente anterior.

429O limite de taxa foi excedido. Respeite o "Retry-After" quando retornado.

Idempotência#

A Gateway aplica idempotência a esta operação de compra. Envie uma solicitação estável X-Idempotency-Key para a mesma tentativa comercial e reutilize a mesma chave e corpo após um timeout de rede. Use uma nova chave para uma tentativa materialmente diferente.

Gere a chave no backend do comerciante, não no código do navegador ou móvel.
Nunca reutilize uma chave com um corpo de solicitação diferente.
Resolva um resultado incerto recuperando a ordem antes de iniciar uma nova tentativa.

Consulte o Entrada completa do endpoint, Autenticaçãoe Códigos de erro.

Esta página foi útil?