Merchant Integration

What is the Merchant Model?

As a merchant partner, you integrate with iGV to provide your users with access to game products available on the iGV platform. The integration enables a streamlined user experience between your platform and iGV.

Key Capabilities

• Buyer account synchronization — Sync your user accounts to iGV and obtain one-time SSO authorization codes
• Merchant-level order query — Retrieve order data for all sellers under your merchant account
• In-platform page redirection — Embed or redirect users to iGV product/order pages

Quick Start

1. Configure keys → Configuration
2. Implement signature → Signature Guide
3. Integrate APIs → API Reference

API List

API	Method	Path	Description
User Sync & Authorization	POST	/pay-fac/{merchant}/{ver}/user	Sync buyer account and get SSO code
Get Order List	POST	/seller/partner/order	Query seller orders (merchant-level)

Authentication

All requests are signed with SHA256withRSA using the merchant's private key. See Signature Guide for details.

Common Response Format

All APIs return a uniform JSON structure:

Field	Type	Description
code	string	Response code; "0000" indicates success
msg	string	Human-readable message
time	string	Server response time (yyyy-MM-dd HH:mm:ss)
data	object	Response data; present only on success

{
  "code": "0000",
  "msg": "Success",
  "time": "2025-04-03 02:55:16",
  "data": { ... }
}

See Error Codes for the full list of code values.