Pagamenti e ordini al dettaglio

In questa pagina

Payload completo per l'ordine al dettaglio
Modella il contesto aziendale
Controllo di avvio

Collega il checkout basato sul prodotto all'orchestrazione dei pagamenti senza perdere i dati necessari per la consegna e il supporto. DEUNA mantiene il catalogo, la promozione, la consegna e il contesto del cliente sullo stesso ordine utilizzato durante l'intero ciclo di vita del pagamento.

Profondità del catalogoMantieni SKU, UPC, marca, categoria, variante, immagine, peso, quantità e prezzi degli articoli.Contesto della promozioneRappresenta sconti per ordini e articoli tramite riferimenti di campagne e coupon stabili.ComplementiAllega l'indirizzo di consegna, il corriere, il metodo di spedizione, le date, il costo e il contesto geografico.

Payload completo per l'ordine al dettaglio#

Questo esempio include una variante di prodotto, un riferimento allo sconto a livello di articolo, lo sconto corrispondente all'ordine, un indirizzo di consegna e un metodo di spedizione selezionato.

Payload completo dell’ordine

Retail

Varianti prodotto, promozione, indirizzo, metodo di consegna e contesto di evasione per il commercio.

Apri la guida del settore

itemsdiscountsshipping_addressshipping_method

Corpo della richiestaJSON

{
  "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"
    }
  }
}

Modella il contesto aziendale#

Requisito	Ordinare i campi
Identità del prodotto	`items[].id`, `sku`, `upc`, `brand`, `category`, `sub_category`
Variante e presentazione	`color`, `size`, `image_url`, `details_url`, `weight`
Promozione	`discounts[]` e articolo `discounts[].ref_idx`
Consegna	`shipping_address`, `shipping_method`, `shipping_options`
Operazioni di evasione	Informazioni sullo store, magazzino, corriere, date di consegna e metadati del commerciante

Controllo di avvio#

Utilizzare identificatori di prodotto e variante immutabili anziché i nomi visualizzati come chiavi.
Mantenere allineati i riferimenti agli sconti tra gli articoli e il livello dell'ordine. discounts array.
Validare l'indirizzo postale, il corriere, le date di spedizione e il costo di spedizione prima del pagamento.
Conservare il token dell'ordine originale per le transazioni di addebito, rimborso, cancellazione e supporto.
Testare modifiche alle promozioni, articoli fuori stock, suddivisione della spedizione, rimborsi parziali e scenari di retry.

Continua con Moduli di controllo, Addebitare e rimborsaree Elaborare il pagamento di un ordine.