Account

Update current account

Updates settings for the authenticated account. Accepts all parameters from Create Account plus the ones listed here.

put/accounts/me

Request body

namestring

allow_shipping0 | 1 required

Required. Set to 1 to allow shipping on orders.

value_shippingnumber

Required when allow_shipping is 1. Shipping fee value.

fee_shippingnumber

Shipping fee amount (alternative to value_shipping).

business_phonestring

Must be a valid phone number.

business_descriptionstring

Description of the account/business.

imagestring

Base64-encoded image or URL for the account logo.

custom_domainstring

Custom domain URL.

addon_accountstring

Addon's account credential.

subaccountsinteger[]

Array of subaccount IDs associated with this account.

allowed_gatewaysstring[]

Array of allowed gateways for the account.

Default payment gateway.

psd2_enabled0 | 1

metadataobject

Example request

{
  "name": "My Company",
  "allow_shipping": 0,
  "business_phone": "+34666999666",
  "business_description": "Description of the business"
}

Response

Updated account

selfstring

merchant_idstring

Unique merchant identifier (addon_key).

namestring

emailstring email

currencystring

country_codestring

business_urlstring nullable

business_phonestring nullable

business_descriptionstring nullable

image_urlstring nullable

public_keystring

secret_keystring

Secret API key. Only visible to the account owner.

allow_shipping0 | 1

value_shippingnumber

is_activeboolean

psd2_enabled0 | 1

allowed_gatewaysstring[]

gatewaysobject[] nullable

List of configured payment gateway objects for the account.

default_gatewaystring nullable

created_atstring date-time nullable

Example response

{
  "self": "/2.0/accounts/me",
  "name": "My Company",
  "currency": "EUR",
  "country_code": "ES"
}

Changes

Changed in 1 of the 4 revisions of this API.18

Mar 11, 2026ff825f6602c818See the full diff
- ▲
  the request property allow_shipping became required
  request-property-became-required
- ○
  added the new optional request property addon_account
  new-optional-request-property
- ○
  added the new optional request property allowed_gateways
  new-optional-request-property
- ○
  added the new optional request property custom_domain
  new-optional-request-property
- ○
  added the new optional request property default_gateway
  new-optional-request-property
- ○
  added the new optional request property fee_shipping
  new-optional-request-property
- ○
  added the new optional request property psd2_enabled
  new-optional-request-property
- ○
  added the new optional request property subaccounts
  new-optional-request-property
- ○
  added the optional property gateways to the response with the 200 status
  response-optional-property-added

Full history