Session creation payloads now include ISO 3166-2 province codes

As of the Payments Apps API version 2025-07, session creation payloads now include a new field for standardized province codes. For example, ON represents Ontario, and QC represents Québec. The province field, which contains the name of the province as a string, remains in the payload. This addition ensures more reliable handling of provinces by eliminating translation inconsistencies and guaranteeing accurate regional identification.

The updated payload structure is as follows:

{
  "province": "Québec",
+ "province_code": "QC",
  "country_code": "CA"
}

The province code adheres to the ISO 3166-2 standard and is available in API version 2025-07 and later. Existing payment apps that rely solely on province names will continue to function without any changes. For detailed implementation guidance, please refer to our payment processing documentation.