flintDocs

Payment method domains

The Payment method domain object#

Every field on a payment method domain, as returned by retrieve and carried by the endpoints below.

Attributes

created_atstringRequired

RFC3339 timestamp.

domain_namestringRequired
payment_method_domain_idstringRequired
payment_optionsarray of objectRequired
statusenumRequired
  • active
  • inactive
updated_atstringRequired

RFC3339 timestamp.

validation_statusenumRequired
  • active
  • action_required
  • unavailable

List payment method domains#

GET/v1/payment-method-domains

Requires scope payments.payment_method_domains.read or payments.payment_method_domains.write

Returns payment method domains ordered by payment_method_domain_id ascending in the selected Flint environment. Page tokens are opaque, bind to the list parameters, and return a validation error when invalid or mismatched.

Query parameters

page_sizeinteger

Page size, default 20, max 100.

page_tokenstring

Cursor returned by the previous list response.

Response · 200

dataarray of objectRequired
metaobject
next_page_tokenstring
request_idstring
curl https://api.withflintpay.com/v1/payment-method-domains \
  -H "Flint-Version: 2026-09-07" \
  -H "Authorization: Bearer YOUR_API_KEY"

Register payment method domain#

POST/v1/payment-method-domainsIdempotent

Requires scope payments.payment_method_domains.write

Registers one exact domain or subdomain for Apple Pay and Google Pay in the selected Flint environment, then validates its wallet readiness.

Request body

domain_namestringRequired

Exact fully-qualified hostname to register. Do not include a scheme, path, port, IP address, or wildcard.

Response · 201

dataobjectRequired
metaobject
request_idstring
curl -X POST https://api.withflintpay.com/v1/payment-method-domains \
  -H "Flint-Version: 2026-09-07" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: a-unique-key" \
  -d '{
    "domain_name": ""
  }'

Get payment method domain#

GET/v1/payment-method-domains/{payment_method_domain_id}

Requires scope payments.payment_method_domains.read or payments.payment_method_domains.write

Returns one environment-scoped payment method domain and its Apple Pay and Google Pay readiness.

Path parameters

payment_method_domain_idstringRequired

Flint payment method domain ID.

Response · 200

Same response as Register payment method domain.

curl https://api.withflintpay.com/v1/payment-method-domains/{payment_method_domain_id} \
  -H "Flint-Version: 2026-09-07" \
  -H "Authorization: Bearer YOUR_API_KEY"

Update payment method domain#

PATCH/v1/payment-method-domains/{payment_method_domain_id}Idempotent

Requires scope payments.payment_method_domains.write

Sets the domain registration status. Activating the domain also validates Apple Pay and Google Pay readiness.

Path parameters

payment_method_domain_idstringRequired

Flint payment method domain ID.

Request body

statusenumRequired
  • active
  • inactive

Response · 200

Same response as Register payment method domain.

curl -X PATCH https://api.withflintpay.com/v1/payment-method-domains/{payment_method_domain_id} \
  -H "Flint-Version: 2026-09-07" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: a-unique-key" \
  -d '{
    "status": "active"
  }'

Was this helpful?