Common Types

Elevate, May 20-22-2025, Miami Beach, Florida

Common API Types used within multiple API resources.

Representations

Amount

Money in cent amounts for a specific currency.

centAmount
Int

Amount in the smallest indivisible unit of a currency, such as:

  • Cents for EUR and USD, pence for GBP, or centime for CHF (5 CHF is specified as 500).
  • The value in the major unit for currencies without minor units, like JPY (5 JPY is specified as 5).
currencyCode
String

Region

The Region in which the Checkout application is hosted.

europe-west1.gcp

for Europe (Google Cloud, Belgium)

us-central1.gcp

for North America (Google Cloud, Iowa)

australia-southeast1.gcp

for Australia (Google Cloud, Sydney)

ReferenceTypeId

Type of resource the value should reference. Supported resource type identifiers are:

cart

References a Cart.

order

References an Order.

payment

References a Payment.

application

References an Application.

payment-integration

References a Payment Integration.

DateTime

A DateTime is a JSON string representation of UTC date & time in ISO 8601 format (YYYY-MM-DDThh:mm:ss.sssZ), for example:

"2018-10-12T14:00:00.000Z"

Reference

A Reference represents a loose reference to another resource, and each resource type has its corresponding Reference type, like CartReference.

ApplicationReference

Reference to an Application.

id
String

Unique identifier of the referenced Application.

typeId
application

Type of referenced resource.

CartReference

Reference to a Cart.

id
String

Unique identifier of the referenced Cart.

typeId
cart

Type of referenced resource.

OrderReference

Reference to an Order.

id
String

Unique identifier of the referenced Order.

typeId
order

Type of referenced resource.

PaymentReference

Reference to a Payment.

id
String

Unique identifier of the referenced Payment.

typeId
payment

Type of referenced resource.

PaymentIntegrationReference

Reference to a Payment Integration.

id
String

Unique identifier of the referenced Payment Integration.

typeId
payment-integration

Type of referenced resource.

Resource Identifier

Draft type to create a Reference to a resource.

ApplicationResourceIdentifier

Resource identifier to an Application. Either id or key is required. If both are set, an InvalidJsonInput error is returned.

id
String

Unique identifier of the referenced Application. Required if key is absent.

typeId
application

Type of referenced resource. If given, it must match the expected ReferenceTypeId of the referenced resource.

key
String

User-defined unique identifier of the referenced Application. Required if id is absent.

CartResourceIdentifier

Resource identifier to a Cart. Either id or key is required. If both are set, an InvalidJsonInput error is returned.

id
String

Unique identifier of the referenced Cart. Required if key is absent.

typeId
cart

Type of referenced resource. If given, it must match the expected ReferenceTypeId of the referenced resource.

key
String

User-defined unique identifier of the referenced Cart. Required if id is absent.

OrderResourceIdentifier

Resource identifier to an Order. Either id or key is required. If both are set, an InvalidJsonInput error is returned.

id
String

Unique identifier of the referenced Order. Required if key is absent.

typeId
order

Type of referenced resource. If given, it must match the expected ReferenceTypeId of the referenced resource.

key
String

User-defined unique identifier of the referenced Order. Required if id is absent.

PaymentResourceIdentifier

Resource identifier to a Payment. Either id or key is required. If both are set, an InvalidJsonInput error is returned.

id
String

Unique identifier of the referenced Payment. Required if key is absent.

typeId
payment

Type of referenced resource. If given, it must match the expected ReferenceTypeId of the referenced resource.

key
String

User-defined unique identifier of the referenced Payment. Required if id is absent.

PaymentIntegrationResourceIdentifier

Resource identifier to a Payment Integration. Either id or key is required. If both are set, an InvalidJsonInput error is returned.

id
String

Unique identifier of the referenced Payment Integration. Required if key is absent.

typeId
payment-integration

Type of referenced resource. If given, it must match the expected ReferenceTypeId of the referenced resource.

key
String

User-defined unique identifier of the referenced Payment Integration. Required if id is absent.