Pular para o conteúdo principal
Todos os sistemas operacionaisNovidadesv1
Entrar
Industry solution

Pagamentos e pedidos para varejo

Construa checkout de varejo com produto, variante, promoção, envio, entrega e contexto do cliente.

Nesta página

Conecte o checkout de produto ao orquestração de pagamento, sem perder os dados necessários para a entrega e suporte. A DEUNA mantém o contexto do catálogo, promoção, entrega e cliente no mesmo pedido usado ao longo do ciclo de vida do pagamento.

Profundidade do catálogoCarregue SKU, UPC, marca, categoria, variante, imagem, peso, quantidade e preços de itens.Contexto de promoçãoRepresente descontos em pedidos e itens com referências de campanhas e cupons estáveis.CumprimentoAnexe o endereço de entrega, o transportador, o método de envio, datas, custo e contexto geográfico.

Payload completo de pedido de varejo#

Este exemplo inclui uma variação de produto, uma referência de desconto de nível de item, o desconto correspondente no pedido, um endereço de entrega e um método de envio selecionado.

Payload completo do pedido

Varejo

Variantes de produto, promoção, endereço, método de entrega e contexto de fulfillment para comércio.

Abrir guia do setor
itemsdiscountsshipping_addressshipping_method
Corpo da solicitaçãoJSON
{
  "order_type": "DEUNA_CHECKOUT",
  "order": {
    "order_id": "retail-93418",
    "store_code": "es-online",
    "currency": "EUR",
    "items_total_amount": 10900,
    "sub_total": 11400,
    "shipping_amount": 500,
    "total_tax_amount": 2152,
    "total_discount": 1000,
    "total_amount": 13552,
    "items": [
      {
        "id": "shoe-runner-42-blue",
        "sku": "RUNNER-BLU-42",
        "upc": "8437012345678",
        "name": "Runner trainers",
        "description": "Everyday lightweight trainers",
        "quantity": 1,
        "brand": "Northline",
        "category": "footwear",
        "sub_category": "trainers",
        "color": "navy",
        "size": "42",
        "taxable": true,
        "image_url": "https://merchant.example.com/products/runner-blue.jpg",
        "details_url": "https://merchant.example.com/products/runner-blue",
        "unit_price": {
          "amount": 11900,
          "currency": "EUR",
          "currency_symbol": "€"
        },
        "total_amount": {
          "amount": 10900,
          "original_amount": 11900,
          "currency": "EUR",
          "currency_symbol": "€",
          "total_discount": 1000
        },
        "tax_amount": {
          "amount": 2052,
          "currency": "EUR",
          "currency_symbol": "€"
        },
        "weight": {
          "weight": 850,
          "unit": "g"
        },
        "discounts": [
          {
            "amount": 1000,
            "ref_idx": 0
          }
        ]
      }
    ],
    "discounts": [
      {
        "amount": 1000,
        "code": "WELCOME10",
        "reference": "campaign-2026-welcome",
        "description": "Welcome discount",
        "details_url": "https://merchant.example.com/promotions/welcome10",
        "free_shipping": {
          "is_free_shipping": false,
          "maximum_cost_allowed": 0
        },
        "discount_category": "coupon",
        "target_type": "items",
        "type": "fixed_amount"
      }
    ],
    "shipping_address": {
      "first_name": "Alex",
      "last_name": "Morgan",
      "email": "alex@example.com",
      "phone": "+34600000000",
      "address1": "Calle de Alcalá 125",
      "address2": "3B",
      "city": "Madrid",
      "zipcode": "28009",
      "state_name": "Madrid",
      "state_code": "MD",
      "country_code": "ES",
      "address_type": "home",
      "is_default": true
    },
    "shipping_method": {
      "code": "standard-48h",
      "name": "Standard delivery",
      "min_delivery_date": "2026-10-05",
      "max_delivery_date": "2026-10-06",
      "cost": 500,
      "display_cost": "€5.00",
      "tax_amount": 100,
      "display_tax_amount": "€1.00",
      "scheduler": []
    },
    "shipping_options": {
      "type": "delivery",
      "method": "standard-48h",
      "carrier": "Merchant Logistics",
      "price": {
        "amount": 500,
        "currency": "EUR"
      },
      "requires_shipping": true,
      "details": {
        "store_id": "es-online",
        "store_name": "Online store",
        "address": "Calle de Alcalá 125, Madrid",
        "address_coordinates": {
          "lat": 40.4217,
          "lng": -3.6772
        },
        "contact": {
          "name": "Customer care",
          "phone": "+34910000000"
        },
        "additional_details": {
          "address_notes": "Leave with the concierge."
        }
      }
    },
    "payer_info": {
      "email": "alex@example.com"
    },
    "channel_type": "desktop_web",
    "metadata": {
      "vertical": "retail",
      "fulfillment_node": "warehouse-mad-02"
    },
    "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#

RequisitoCampos de pedido
Identificação do produtoitems[].id, sku, upc, brand, category, sub_category
Variação e apresentaçãocolor, size, image_url, details_url, weight
Promoçãodiscounts[] e item discounts[].ref_idx
Entregashipping_address, shipping_method, shipping_options
Operações de fulfillmentLoja, armazém, transportador, datas de entrega e metadados do comerciante

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

  • Utilize identificadores de produto e variação imutáveis em vez de nomes de exibição como chaves.
  • Mantenha as referências de desconto alinhadas entre itens e o nível do pedido discounts array.
  • Valide o endereço postal, o transportador, as datas de envio e o custo de entrega antes do pagamento.
  • Preserve o token de pedido original para fluxos de captura, reembolso, cancelamento e suporte.
  • Teste alterações de promoções, itens indisponíveis, divisão de fulfillment, reembolso parcial e cenários de repetição.

Continuar com Módulos de check-out, Captura e reembolsose Processar o pagamento do pedido.