Callback Notification Overview

The iGV platform proactively pushes notifications to the seller's configured callback URL when an order status changes.

How It Works

Order status changes → iGV platform constructs request → Signs → POSTs to seller callback URL → Seller verifies and processes

Prerequisites

Item	Description
Callback URL	The seller must provide a callback URL to the iGV platform in advance
Secret Key	A key assigned by the iGV platform for signature verification

Seller Implementation Requirements

• Accept POST requests with a JSON body
• Verify the request signature (Signature Verification)
• Implement idempotency based on X-Request-Id
• Return HTTP 200 on success

Currently Supported Callback Events

Event	Trigger Condition	Description
Order Status Callback	sellerOrderStatus = 1	Order has been paid and passed risk review; awaiting seller delivery

Future Extensions

Currently only sellerOrderStatus = 1 triggers a callback notification. Callbacks for other status changes will be supported in future versions.

Callback Request Format

POST {seller_callback_url}
Content-Type: application/json
X-Request-Id: <unique request ID>
X-Timestamp: <millisecond timestamp>
X-Signature: <HMAC-SHA256 signature>

Related Documentation

• Order Status Callback — Request body structure and field descriptions
• Signature Verification — Verification algorithm and code examples
• Retry Mechanism — Failure retry rules