Cycle de vie d'une commande (après l'achat)

Une fois le paiement effectué et la commande passée, vous devez envoyer des mises à jour de l'état à Google à l'aide de Webhooks. La clé API doit être envoyée dans les paramètres de requête ou les en-têtes.

1. Événement "Commande créée"

• Déclencheur : immédiatement après la confirmation de la commande (status: PROCESSING).
• Point de terminaison : POST /webhooks/partners/{partner_id}/events/order

Charge utile : vous devez envoyer l'entité de commande complète.

{
  "ucp": { "version": "2026-01-01", "capabilities": [...] },
  "id": "gid://https://merchant.com/Order/789",
  "checkout_id": "https://merchant.com/Checkout/session_abc123",
  "line_items": [
      {
          "id": "line_1",
          "status": "processing",
          "item": {
            "id": "product_12345",
            "title": "Running Shoes",
            "price": 10000
          },
          "quantity": 1,
          "base_amount": 10000,
          "total": 10000
      }
  ],
  "totals": [
      { "type": "total", "amount": 11350 }
  ],
  "fulfillment_details": [
    {
      "id": "fulfillment_1",
      "status": "processing",
      "expected_fulfillment_time": "2026-01-10T12:00:00Z"
    }
  ],
  "permalink_url": "https://merchant.com/orders/789"
}

2. Notifications sur les commandes (expédition/annulation)

• Déclencheur : lorsqu'une modification est apportée à l'état de la commande (par exemple, lorsqu'un article est expédié ou annulé).
• Exigence : Vous devez renvoyer l'entité de commande complète, et non une mise à jour partielle.

Exemple (expédié) :

{
  "id": "gid://https://merchant.com/Order/789",
  "checkout_id": "gid://https://merchant.com/Checkout/session_abc123",
  // Full line items must be included
  "line_items": [ ... ],
  "totals": [ ... ],
  // Updated fulfillment details
  "fulfillment_details": [
    {
      "id": "fulfillment_1",
      "status": "shipped",
      "tracking_identifier": "1Z9999999999",
      "fulfillment_tracking_url": "https://carrier.com/track/1Z..."
    }
  ],
  "permalink_url": "https://merchant.com/orders/789"
}