# Account

Merchant account.

```
type Account {

  id: ID!

  externalId: String

  masterAccountId: ID

  name: String

  paymentMethods: AccountPaymentMethods @deprecated

  publicBusinessDetails: AccountPublicBusinessDetails

  branding: AccountBranding

  defaultCurrency: Currencies @deprecated

  test: Boolean

  blocked: Boolean

  status: AccountStatus!

  reason: String @deprecated

  timezone: String

  adminEmail: String

  apiKey: String

  customDomain: String

  customDomainConfig: CustomDomainConfig

  payoutTerms: AccountPayoutTerms

  business: BusinessData

  representatives: [Representative!]

  iban: String

  bankAccount: BankAccount

  language: String

  tokenizationMethods: AccountTokenizationMethods

  notifications: AccountNotifications

  billingPlan: BillingPlans

  contract: AccountContract

  referralCode: String

  promoCode: String

  allowCreateApiKey: Boolean

  previewFeatures: [String!]

  notConfiguredReason: NotConfiguredReason @deprecated

  notConfiguredNote: String @deprecated

  userNote: String

  createdAt: String!

  approvedAt: String

  updatedAt: String

  rejectedReason: RejectedReason @deprecated

  rejectedNote: String @deprecated

  statusReason: StatusReason

  statusNote: String

  fraudDetectorThreshold: Int

  fraudDetectorEnabled: Boolean

}
```

### Fields[​](#fields "Direct link to Fields")

#### [`Account.id`](#id) ● [`ID!`](https://docs.monei.com/apis/graphql/types/scalars/id/.md) non-null scalar[​](#id "Direct link to id")

Account ID.

#### [`Account.externalId`](#external-id) ● [`String`](https://docs.monei.com/apis/graphql/types/scalars/string/.md) scalar[​](#external-id "Direct link to external-id")

Partner-assigned external ID for sub-accounts of a master account.

#### [`Account.masterAccountId`](#master-account-id) ● [`ID`](https://docs.monei.com/apis/graphql/types/scalars/id/.md) scalar[​](#master-account-id "Direct link to master-account-id")

Master account ID when this account is a sub-account.

#### [`Account.name`](#name) ● [`String`](https://docs.monei.com/apis/graphql/types/scalars/string/.md) scalar[​](#name "Direct link to name")

Internal account name (not shown to customers).

#### [`Account.paymentMethods`](#payment-methods) ● [`AccountPaymentMethods`](https://docs.monei.com/apis/graphql/types/objects/account-payment-methods/.md) deprecated object[​](#payment-methods "Direct link to payment-methods")

DEPRECATED

Not used.

#### [`Account.publicBusinessDetails`](#public-business-details) ● [`AccountPublicBusinessDetails`](https://docs.monei.com/apis/graphql/types/objects/account-public-business-details/.md) object[​](#public-business-details "Direct link to public-business-details")

Public business information shown to customers.

#### [`Account.branding`](#branding) ● [`AccountBranding`](https://docs.monei.com/apis/graphql/types/objects/account-branding/.md) object[​](#branding "Direct link to branding")

Visual branding applied to customer-facing surfaces.

#### [`Account.defaultCurrency`](#default-currency) ● [`Currencies`](https://docs.monei.com/apis/graphql/types/enums/currencies/.md) deprecated enum[​](#default-currency "Direct link to default-currency")

DEPRECATED

Not used.

#### [`Account.test`](#test) ● [`Boolean`](https://docs.monei.com/apis/graphql/types/scalars/boolean/.md) scalar[​](#test "Direct link to test")

Whether this is a test account.

#### [`Account.blocked`](#blocked) ● [`Boolean`](https://docs.monei.com/apis/graphql/types/scalars/boolean/.md) scalar[​](#blocked "Direct link to blocked")

Whether the account is blocked from processing payments.

#### [`Account.status`](#status) ● [`AccountStatus!`](https://docs.monei.com/apis/graphql/types/enums/account-status/.md) non-null enum[​](#status "Direct link to status")

Lifecycle status.

#### [`Account.reason`](#reason) ● [`String`](https://docs.monei.com/apis/graphql/types/scalars/string/.md) deprecated scalar[​](#reason "Direct link to reason")

DEPRECATED

Use `statusReason`.

#### [`Account.timezone`](#timezone) ● [`String`](https://docs.monei.com/apis/graphql/types/scalars/string/.md) scalar[​](#timezone "Direct link to timezone")

Default IANA timezone (e.g. `Europe/Madrid`).

#### [`Account.adminEmail`](#admin-email) ● [`String`](https://docs.monei.com/apis/graphql/types/scalars/string/.md) scalar[​](#admin-email "Direct link to admin-email")

Primary admin email.

#### [`Account.apiKey`](#api-key) ● [`String`](https://docs.monei.com/apis/graphql/types/scalars/string/.md) scalar[​](#api-key "Direct link to api-key")

API key used to authenticate REST and GraphQL requests for this account.

#### [`Account.customDomain`](#custom-domain) ● [`String`](https://docs.monei.com/apis/graphql/types/scalars/string/.md) scalar[​](#custom-domain "Direct link to custom-domain")

Custom domain serving the hosted payment page.

#### [`Account.customDomainConfig`](#custom-domain-config) ● [`CustomDomainConfig`](https://docs.monei.com/apis/graphql/types/objects/custom-domain-config/.md) object[​](#custom-domain-config "Direct link to custom-domain-config")

Custom domain DNS and certificate state.

#### [`Account.payoutTerms`](#payout-terms) ● [`AccountPayoutTerms`](https://docs.monei.com/apis/graphql/types/objects/account-payout-terms/.md) object[​](#payout-terms "Direct link to payout-terms")

Settlement (payout) terms.

#### [`Account.business`](#business) ● [`BusinessData`](https://docs.monei.com/apis/graphql/types/objects/business-data/.md) object[​](#business "Direct link to business")

Legal and operational details of the business.

#### [`Account.representatives`](#representatives) ● [`[Representative!]`](https://docs.monei.com/apis/graphql/types/objects/representative/.md) list object[​](#representatives "Direct link to representatives")

Legal representatives and beneficial owners.

#### [`Account.iban`](#iban) ● [`String`](https://docs.monei.com/apis/graphql/types/scalars/string/.md) scalar[​](#iban "Direct link to iban")

IBAN where settlements are deposited.

#### [`Account.bankAccount`](#bank-account) ● [`BankAccount`](https://docs.monei.com/apis/graphql/types/objects/bank-account/.md) object[​](#bank-account "Direct link to bank-account")

Settlement bank account verification details.

#### [`Account.language`](#language) ● [`String`](https://docs.monei.com/apis/graphql/types/scalars/string/.md) scalar[​](#language "Direct link to language")

Preferred dashboard / communications language (BCP-47, e.g. `en`).

#### [`Account.tokenizationMethods`](#tokenization-methods) ● [`AccountTokenizationMethods`](https://docs.monei.com/apis/graphql/types/objects/account-tokenization-methods/.md) object[​](#tokenization-methods "Direct link to tokenization-methods")

Tokenization wallets configured for the account.

#### [`Account.notifications`](#notifications) ● [`AccountNotifications`](https://docs.monei.com/apis/graphql/types/objects/account-notifications/.md) object[​](#notifications "Direct link to notifications")

Email notification preferences.

#### [`Account.billingPlan`](#billing-plan) ● [`BillingPlans`](https://docs.monei.com/apis/graphql/types/enums/billing-plans/.md) enum[​](#billing-plan "Direct link to billing-plan")

Commercial billing plan.

#### [`Account.contract`](#contract) ● [`AccountContract`](https://docs.monei.com/apis/graphql/types/objects/account-contract/.md) object[​](#contract "Direct link to contract")

MONEI services contract envelope.

#### [`Account.referralCode`](#referral-code) ● [`String`](https://docs.monei.com/apis/graphql/types/scalars/string/.md) scalar[​](#referral-code "Direct link to referral-code")

Referral code shared by this merchant to invite others.

#### [`Account.promoCode`](#promo-code) ● [`String`](https://docs.monei.com/apis/graphql/types/scalars/string/.md) scalar[​](#promo-code "Direct link to promo-code")

Promo code applied to this account at signup.

#### [`Account.allowCreateApiKey`](#allow-create-api-key) ● [`Boolean`](https://docs.monei.com/apis/graphql/types/scalars/boolean/.md) scalar[​](#allow-create-api-key "Direct link to allow-create-api-key")

Whether the merchant is allowed to create new API keys.

#### [`Account.previewFeatures`](#preview-features) ● [`[String!]`](https://docs.monei.com/apis/graphql/types/scalars/string/.md) list scalar[​](#preview-features "Direct link to preview-features")

Preview feature flags enabled for this account.

#### [`Account.notConfiguredReason`](#not-configured-reason) ● [`NotConfiguredReason`](https://docs.monei.com/apis/graphql/types/enums/not-configured-reason/.md) deprecated enum[​](#not-configured-reason "Direct link to not-configured-reason")

DEPRECATED

Use `statusReason`.

#### [`Account.notConfiguredNote`](#not-configured-note) ● [`String`](https://docs.monei.com/apis/graphql/types/scalars/string/.md) deprecated scalar[​](#not-configured-note "Direct link to not-configured-note")

DEPRECATED

Use `statusNote`.

#### [`Account.userNote`](#user-note) ● [`String`](https://docs.monei.com/apis/graphql/types/scalars/string/.md) scalar[​](#user-note "Direct link to user-note")

Free-form note provided by the merchant during onboarding.

#### [`Account.createdAt`](#created-at) ● [`String!`](https://docs.monei.com/apis/graphql/types/scalars/string/.md) non-null scalar[​](#created-at "Direct link to created-at")

Account creation date (ISO 8601).

#### [`Account.approvedAt`](#approved-at) ● [`String`](https://docs.monei.com/apis/graphql/types/scalars/string/.md) scalar[​](#approved-at "Direct link to approved-at")

Date the account was approved by compliance (ISO 8601).

#### [`Account.updatedAt`](#updated-at) ● [`String`](https://docs.monei.com/apis/graphql/types/scalars/string/.md) scalar[​](#updated-at "Direct link to updated-at")

Date the account was last updated (ISO 8601).

#### [`Account.rejectedReason`](#rejected-reason) ● [`RejectedReason`](https://docs.monei.com/apis/graphql/types/enums/rejected-reason/.md) deprecated enum[​](#rejected-reason "Direct link to rejected-reason")

DEPRECATED

Use `statusReason`.

#### [`Account.rejectedNote`](#rejected-note) ● [`String`](https://docs.monei.com/apis/graphql/types/scalars/string/.md) deprecated scalar[​](#rejected-note "Direct link to rejected-note")

DEPRECATED

Use `statusNote`.

#### [`Account.statusReason`](#status-reason) ● [`StatusReason`](https://docs.monei.com/apis/graphql/types/enums/status-reason/.md) enum[​](#status-reason "Direct link to status-reason")

Reason for the current `status`.

#### [`Account.statusNote`](#status-note) ● [`String`](https://docs.monei.com/apis/graphql/types/scalars/string/.md) scalar[​](#status-note "Direct link to status-note")

Free-form note about the current `status`.

#### [`Account.fraudDetectorThreshold`](#fraud-detector-threshold) ● [`Int`](https://docs.monei.com/apis/graphql/types/scalars/int/.md) scalar[​](#fraud-detector-threshold "Direct link to fraud-detector-threshold")

Fraud-detector score threshold (0-1000). Card payments scoring above this value are declined. `0` is lowest risk, `1000` highest.

#### [`Account.fraudDetectorEnabled`](#fraud-detector-enabled) ● [`Boolean`](https://docs.monei.com/apis/graphql/types/scalars/boolean/.md) scalar[​](#fraud-detector-enabled "Direct link to fraud-detector-enabled")

Whether the fraud detector is enabled for the account.

### Returned By[​](#returned-by "Direct link to Returned By")

[`account`](https://docs.monei.com/apis/graphql/operations/queries/account/.md) query ● [`connectMasterAccount`](https://docs.monei.com/apis/graphql/operations/mutations/connect-master-account/.md) mutation ● [`disableCustomDomain`](https://docs.monei.com/apis/graphql/operations/mutations/disable-custom-domain/.md) mutation ● [`disableTokenizationMethod`](https://docs.monei.com/apis/graphql/operations/mutations/disable-tokenization-method/.md) mutation ● [`disconnectMasterAccount`](https://docs.monei.com/apis/graphql/operations/mutations/disconnect-master-account/.md) mutation ● [`enableCustomDomain`](https://docs.monei.com/apis/graphql/operations/mutations/enable-custom-domain/.md) mutation ● [`enableTokenizationMethod`](https://docs.monei.com/apis/graphql/operations/mutations/enable-tokenization-method/.md) mutation ● [`requestAccountReview`](https://docs.monei.com/apis/graphql/operations/mutations/request-account-review/.md) mutation ● [`setupAccount`](https://docs.monei.com/apis/graphql/operations/mutations/setup-account/.md) mutation ● [`startCompanyLookup`](https://docs.monei.com/apis/graphql/operations/mutations/start-company-lookup/.md) mutation ● [`updateAccount`](https://docs.monei.com/apis/graphql/operations/mutations/update-account/.md) mutation ● [`verifyBusinessDetails`](https://docs.monei.com/apis/graphql/operations/mutations/verify-business-details/.md) mutation ● [`verifyCustomDomain`](https://docs.monei.com/apis/graphql/operations/mutations/verify-custom-domain/.md) mutation