Skip to content
Console
Menu

Generated Assets

Workflows

Getting Started

Authentication

KV Store

Get a checkout policy

Gets the environment's checkout policy: which buyer countries consumer checkout refuses.

Gets the environment's checkout policy: which buyer countries consumer checkout refuses. An environment that never wrote one refuses none.

  • Path GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/checkout_policies/checkout-policy
  • Scope billing:read
  • Effect read — nothing is written.
  • Collection checkout_policies

#Request

FieldTypeWhat it is
namestringThe name of the checkout policy to get. Required.

#Response

FieldTypeWhat it is
namestringorgs/{org}/projects/{project}/envs/{env}/checkout_policies/default.
uidstringcpl_<cell><ulid>; never reused. Output only.
metaResourceMetaResource metadata.
specCheckoutPolicySpecDesired state. Required.

#ResourceMeta

FieldTypeWhat it is
generationint64Increases by one on every change to spec. Output only.
etagstringStrong ETag (AIP-154): changes on any change to spec, status, or metadata. Send it back as If-Match or etag to make Update and Delete conditional; a mismatch fails with ABORTED / 409 ETAG_MISMATCH. Output only.
create_timetimestampWhen the Resource was created. Output only.
update_timetimestampWhen the Resource last changed. Output only.
delete_timetimestampSet while the Resource is being deleted. Output only.
labelsmap<string, string>Caller-writable, indexed labels (AIP-122 label rules).
annotationsmap<string, string>Caller-writable, unindexed annotations.
display_namestringCaller-writable human-readable name.
creatorstringThe principal that created the Resource. Output only.

#CheckoutPolicySpec

FieldTypeWhat it is
denied_country_codesstring[]Buyer countries consumer checkout refuses: ISO 3166-1 alpha-2 codes (DE), or the group EU (the 27 member states). At most 300 entries. Empty refuses nobody.
allow_tax_id_buyersboolWhether a buyer from a denied country who gives a tax id (a business) may still buy. Checkout then asks for the tax id; default false.

#Errors

Every error arrives in the body Errors describes.

#Examples

curl "https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/checkout_policies/checkout-policy" \
  -H "Authorization: Bearer $SYLPHX_API_KEY"