API Changelog - 2026-07-21: Summary
The state field in billing address and sub-merchant address schemas
has been updated to support a wider range of ISO subdivision codes:
minLength changed from 2 to 1 and maxLength changed from 2 to 3.
Sub-merchant country field descriptions have also been clarified.
Summary
The following shared schema components were updated. These components are used across Card (Visa, Mastercard, Maestro), Klarna, and FundsTransfer payment method request and response bodies.
state field — Billing address (Card and Klarna)
The state field in BillingAddressData for Card and Klarna payment
methods has been updated to accept a broader range of ISO subdivision
codes. The field length constraints have changed.
| Property | Details |
|---|---|
| Name | paymentMethod.billingAddress.state |
| Location | Request body |
| Type | string |
| Required | No (optional) |
| Format | ISO subdivision code — length 1–3 characters |
| Example | "CA" |
state field — FundsTransfer sender address
The state field in AddressData for the Card FundsTransfer sender
has been updated with the same length changes.
| Property | Details |
|---|---|
| Name | paymentMethod.sender.address.state |
| Location | Request body |
| Type | string |
| Required | No (optional) |
| Format | ISO subdivision code — length 1–3 characters |
| Example | "NY" |
state field — Sub-merchant data (request and response)
The state field in both SubMerchantData (request) and
GetSubMerchantData (response) schemas has been updated. Following
the Countries and states guideline is now mandatory for this
field.
| Property | Details |
|---|---|
| Name | paymentMethod.subMerchant.state |
| Location | Request body / Response body |
| Type | string |
| Required | Yes (for us and ca) |
| Format | ISO subdivision code — length 1–3 characters |
| Example | "TX" |
country field — Sub-merchant data (request and response)
The country field description in SubMerchantData and
GetSubMerchantData has been updated to clarify that allowed values
depend on your processing account configuration.
| Property | Details |
|---|---|
| Name | paymentMethod.subMerchant.country |
| Location | Request body / Response body |
| Type | string |
| Required | Yes |
| Format | ISO 3166-1 Alpha-2 (2-character country code) |
| Example | "US" |