Setelah checkout selesai dan pesanan dilakukan, Anda harus mengirimkan update status ke Google menggunakan Webhook. Kunci API harus dikirim dalam parameter kueri atau header.
1. Peristiwa Pesanan Dibuat
- Pemicu: Segera setelah pesanan dikonfirmasi (
status: PROCESSING). - Endpoint:
POST /webhooks/partners/{partner_id}/events/order
Payload: Anda harus mengirim entity pesanan lengkap.
{
"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. Info Terbaru Pesanan (Pengiriman/Pembatalan)
- Pemicu: Saat ada pembaruan pada status pesanan (misalnya, item dikirim atau dibatalkan).
- Persyaratan: Anda harus mengirim entity pesanan lengkap lagi, bukan hanya pembaruan sebagian.
Contoh (Dikirim):
{
"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"
}