India Conventions

India-specific data conventions for ChargeIndia Hub integrations.

ChargeIndia Hub is built for the Indian EV charging market. Follow these conventions when integrating.

Country and currency

FieldConvention
country_codeIN for Indian parties
CurrencyINR (Indian Rupee) in tariffs and CDRs
TimestampsStored and transmitted in UTC (ISO 8601)

Display times to end users in IST (UTC+5:30) on your platform — the Hub stores UTC.

Party identifiers

Indian parties use:

  • country_code: 2-character ISO code (IN)
  • party_id: 3-character identifier assigned during onboarding (e.g. ABC)

Hub identity: IN / CIH.

GSTIN metadata

Partners may include GSTIN (GST Identification Number) in business_details during credentials exchange. The Hub stores this metadata but does not:

  • Validate GSTIN with government APIs
  • Generate tax invoices
  • Calculate or remit GST

GST invoicing is handled bilaterally between eMSP and CPO outside the Hub.

Pricing

  • Tariffs should use INR with appropriate price_components
  • The Hub passes tariffs through for authorization pricing context only
  • Payment collection is out of scope for Phase 1

UPI prepaid flows and payment authorization gates are planned for a future phase. Phase 1 delivers technical roaming only.

What the Hub does not do

CapabilityStatus
UPI / wallet paymentsPhase 2+
GST invoice generationNever — Hub orchestrates data only
Escrow / settlementOut of scope
Hub commercial billingPhase 4+

Related docs