Criar pagamento

Use esta operação no backend do lojista para criar e pagar um pedido inline em uma única solicitação. Você também pode fornecer o token de um pedido existente. A DEUNA aplica as conexões de pagamento e o comportamento de roteamento, risco e captura configurados para o lojista.

Enviar seleção de parcelasPerguntar à Athia sobre isto#

Quando o cliente seleciona uma opção retornada por Listar opções de parcelamento, preserve os dois valores da mesma opção:

{
  "payment_source": {
    "method_type": "credit_card",
    "card_info": {
      "card_id": "CARD_ID",
      "installments": 6,
      "installment": {
        "plan_option_id": "a4756a5f-7f9b-414d-8712-e3a9da2be337"
      }
    }
  }
}

O número de parcelas e o ID da opção devem corresponder. O ID da opção identifica a opção da campanha/provedor da DEUNA; o número indica o número de parcelas selecionado para o processamento do pagamento. Consulte Parcelas para informações sobre elegibilidade da campanha e o fluxo completo.

Envie um pagamento recorrente com cartãoPerguntar à Athia sobre isto#

Os campos de recorrência pertencem dentro do orderinline. A transação inicial iniciada pelo titular do cartão estabelece a credencial recorrente:

{
  "payer_info": {
    "email": "buyer@example.com"
  },
  "payment_source": {
    "method_type": "credit_card",
    "payment_method": "TOKENIZED_PAYMENT_METHOD"
  },
  "order_type": "DEUNA_CHECKOUT",
  "order": {
    "order_id": "subscription-1001-initial",
    "store_code": "main",
    "currency": "USD",
    "sub_total": 1000,
    "total_tax_amount": 0,
    "total_amount": 1000,
    "initiator_type": "customer",
    "recurrence": {
      "first_time_use": true,
      "scheduled": true,
      "bill_reference": "subscription-1001"
    }
  }
}

Após a primeira cobrança bem-sucedida, retenha o order.recurrence.recurrence_idretornado. Envie esse valor com a cobrança subsequente iniciada pelo lojista:

{
  "payer_info": {
    "email": "buyer@example.com"
  },
  "payment_source": {
    "method_type": "credit_card",
    "payment_method": "STORED_PAYMENT_METHOD"
  },
  "order_type": "DEUNA_CHECKOUT",
  "order": {
    "order_id": "subscription-1001-002",
    "store_code": "main",
    "currency": "USD",
    "sub_total": 1000,
    "total_tax_amount": 0,
    "total_amount": 1000,
    "initiator_type": "merchant",
    "recurrence": {
      "first_time_use": false,
      "scheduled": true,
      "recurrence_id": "RECURRING_CREDENTIAL_ID",
      "bill_reference": "subscription-1001"
    }
  }
}

Use o nome de campo exato recurrence_id; é o contrato JSON público usado pelo Purchase V2. Uma cobrança subsequente sem um identificador válido não pode ser associada à credencial de recorrência armazenada para o processador selecionado.

Escolha como fornecer o pedidoPerguntar à Athia sobre isto#

Inicie com um pedido completo da indústria.Perguntar à Athia sobre isto#

O order aceita o mesmo contexto de negócio modelado pela API de Orders. Cada exemplo de setor começa com a solicitação inline recomendada do Purchase V2 e também permite inspecionar a solicitação opcional de criar o pedido primeiro.

RespostaPerguntar à Athia sobre isto#

Retorna a ordem processada, incluindo seu order_tokentipo de ordem, status resultante, informações de pagamento e informações de assinatura, quando aplicável. Trate o estado retornado como autoritativo. Se permanecer sem resolução, recupere a ordem original após o DEUNA processar a atualização do provedor assíncrona.

Códigos de status

IdempotênciaPerguntar à Athia sobre isto#

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.

Veja Solicitações idempotentes para o período de retenção de 24 horas, comportamento de repetição, conflitos e operações suportadas. Continue com a Entrada completa do endpoint, Autenticaçãoe Códigos de erro.