Pagamentos bancários e pedidos

Nesta página

Payload completo de pedido bancário
Modelar o contexto de negócios
Lista de verificação de produção

Utilize a DEUNA para orquestrar experiências de pagamento dentro de jornadas de serviços bancários digitais, mantendo o produto financeiro e o contexto do cliente associados a cada tentativa. O pedido fornece uma referência comercial estável entre os provedores, tentativas, status e operações.

Fluxo de servidor confiávelCrie e processe pedidos a partir de uma infraestrutura bancária controlada, utilizando credenciais de API privadas.Context do canalIdentifique jornadas móveis, na web, em loja física ou assistidas, sem alterar o contrato de pagamento.Rastreabilidade operacionalReconcilie a referência bancária, o token de pedido da DEUNA, o estado do pagamento e atualizações assíncronas.

Payload completo de pedido bancário#

O exemplo modela um pagamento de conta de crédito direcionado pelo cliente. Referências de produto e conta são metadados definidos pelo comerciante; evite incluir segredos brutos ou números de conta completos no payload.

Payload completo do pedido

Bancos

Produto financeiro, referência de conta mascarada, cliente, canal e descritor para um pagamento de conta.

Abrir guia do setor

descriptionstatement_descriptorinitiator_typemetadata

Corpo da solicitaçãoJSON

{
  "order_type": "DEUNA_CHECKOUT",
  "order": {
    "order_id": "bank-payment-883104",
    "store_code": "digital-banking",
    "currency": "USD",
    "items_total_amount": 12500,
    "sub_total": 12500,
    "total_tax_amount": 0,
    "total_amount": 12500,
    "items": [
      {
        "id": "credit-account-payment",
        "sku": "CARD-PAYMENT",
        "name": "Credit account payment",
        "description": "Customer-directed account payment",
        "quantity": 1,
        "category": "financial_services",
        "type": "service",
        "taxable": false,
        "unit_price": {
          "amount": 12500,
          "currency": "USD",
          "currency_symbol": "$"
        },
        "total_amount": {
          "amount": 12500,
          "original_amount": 12500,
          "currency": "USD",
          "currency_symbol": "$",
          "total_discount": 0
        },
        "tax_amount": {
          "amount": 0,
          "currency": "USD",
          "currency_symbol": "$"
        }
      }
    ],
    "payer_info": {
      "email": "alex@example.com",
      "external_registration_date": "2022-08-14T10:30:00Z"
    },
    "description": "Payment to account ending in 8842",
    "statement_descriptor": "BANK ACCOUNT PMT",
    "initiator_type": "customer",
    "channel_type": "mobile_app_android",
    "metadata": {
      "vertical": "banking",
      "account_reference": "acct_••••8842",
      "product": "credit_card",
      "customer_segment": "premium"
    },
    "callback_urls": {
      "on_success": "https://merchant.example.com/payments/success",
      "on_pending": "https://merchant.example.com/payments/pending",
      "on_reject": "https://merchant.example.com/payments/rejected",
      "on_canceled": "https://merchant.example.com/payments/canceled",
      "on_failed": "https://merchant.example.com/payments/failed"
    }
  }
}

Modelar o contexto de negócios#

Requisito	Campos de pedido
Referência da transação bancária	Estável `order_id` mais uma referência de metadados mascarada ou tokenizada
Produto financeiro	Item de serviço `category`, `type`e nomeado `metadata.product`
Cliente e canal	`payer_info`, `initiator_type`e `channel_type`
Extrato do cliente	`description` e compatível com o provedor `statement_descriptor`
Resultado final	DEUNA `order_token`status do pagamento e eventos de webhook verificados

Lista de verificação de produção#

Defina qual identificador bancário se torna o comerciante imutável order_id.
Mantenha as referências da conta mascaradas ou tokenizadas e exclua credenciais dos metadados.
Aplique idempotência a cada tentativa de negócio e reconcilie os timeouts com o pedido original.
Valide descritores de extrato e métodos de pagamento suportados com os provedores selecionados.
Teste cenários de autenticação, limite, pendente, rejeição, reversão, reembolso e envio duplicado.

Continuar com Autenticação e chaves de API, Idempotênciae Webhooks.