Skip to content

Replace a store's checkout branding

PUT
/v1/stores/{store_id}/branding
curl --request PUT \
--url https://api.feitpay.com/v1/stores/example/branding \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "display_name": "example", "logo_url": "https://example.com", "accent_color": "example", "support_email": "hello@example.com", "support_url": "https://example.com", "website_domain": "example" }'
store_id
required
string
FeitPay-Organization
string

Active organization for dashboard sessions. Ignored for API keys (the key determines the organization).

Media typeapplication/json
object
display_name
required
string
>= 1 characters <= 80 characters
logo_url
string format: uri
/^https:///
accent_color
string
/^#[0-9A-Fa-f]{6}$/
support_email
string format: email
support_url
string format: uri
/^https:///
website_domain
string
<= 253 characters

Example generated

{
"display_name": "example",
"logo_url": "https://example.com",
"accent_color": "example",
"support_email": "hello@example.com",
"support_url": "https://example.com",
"website_domain": "example"
}

Saved. Changing the website domain resets domain verification.

Media typeapplication/json
object
id
required
string
object
required
string
Allowed value: store
organization_id
required
string
name
required
string
website_url
required
string | null
default_currency
required
string
status
required
string
Allowed values: active disabled
sandbox_fixture
required
boolean
branding
required
object
display_name
required
string
logo_url
required
string | null
accent_color
required
string | null
support_email
required
string | null
support_url
required
string | null
website_domain
required
string | null
domain_verified
required
boolean
created_at
required
string format: date-time
updated_at
required
string format: date-time

Example

{
"object": "store",
"status": "active"
}

Missing or invalid credentials.

Media typeapplication/json
object
error
required
object
type
required
string
Allowed values: invalid_request_error authentication_error permission_error not_found_error conflict_error idempotency_error rate_limit_error feature_unavailable_error api_error
code
required
string
message
required
string
param
string
request_id
required
string

Example

{
"error": {
"type": "invalid_request_error"
}
}

Authenticated but not permitted.

Media typeapplication/json
object
error
required
object
type
required
string
Allowed values: invalid_request_error authentication_error permission_error not_found_error conflict_error idempotency_error rate_limit_error feature_unavailable_error api_error
code
required
string
message
required
string
param
string
request_id
required
string

Example

{
"error": {
"type": "invalid_request_error"
}
}

Resource not found (or not visible to this tenant).

Media typeapplication/json
object
error
required
object
type
required
string
Allowed values: invalid_request_error authentication_error permission_error not_found_error conflict_error idempotency_error rate_limit_error feature_unavailable_error api_error
code
required
string
message
required
string
param
string
request_id
required
string

Example

{
"error": {
"type": "invalid_request_error"
}
}

Validation failed.

Media typeapplication/json
object
error
required
object
type
required
string
Allowed values: invalid_request_error authentication_error permission_error not_found_error conflict_error idempotency_error rate_limit_error feature_unavailable_error api_error
code
required
string
message
required
string
param
string
request_id
required
string

Example

{
"error": {
"type": "invalid_request_error"
}
}

Too many requests. See Retry-After.

Media typeapplication/json
object
error
required
object
type
required
string
Allowed values: invalid_request_error authentication_error permission_error not_found_error conflict_error idempotency_error rate_limit_error feature_unavailable_error api_error
code
required
string
message
required
string
param
string
request_id
required
string

Example

{
"error": {
"type": "invalid_request_error"
}
}
Retry-After
integer