Account
Merchant account: business details, settings and onboarding status.
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
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
accountManager: AccountManager
}
Fields
Account.id ● ID! non-null scalar
Account ID.
Account.externalId ● String scalar
Partner-assigned external ID for sub-accounts of a master account.
Account.masterAccountId ● ID scalar
Master account ID when this account is a sub-account.
Account.name ● String scalar
Account name, shown in Settings > Account details. Customers see publicBusinessDetails.companyName instead.
Account.paymentMethods ● AccountPaymentMethods deprecated object
Not used.
**Deprecated.** Not used. Always null.
Account.publicBusinessDetails ● AccountPublicBusinessDetails object
Public business information shown to customers.
Account.branding ● AccountBranding object
Visual branding applied to customer-facing surfaces.
Account.defaultCurrency ● Currencies deprecated enum
Not used.
Default currency of the account. A payment created without currency uses it. The dashboard home page shows totals in it first. New accounts get EUR.
Account.test ● Boolean scalar
Whether this is a test account.
Account.blocked ● Boolean scalar
Whether the account is blocked from processing payments. A blocked account keeps access to the dashboard and the API.
Account.status ● AccountStatus! non-null enum
Lifecycle status. See AccountStatus.
Account.reason ● String deprecated scalar
Use statusReason.
**Deprecated.** Legacy free-form status reason set by MONEI. Use statusReason and statusNote.
Account.timezone ● String scalar
Default IANA timezone (e.g. Europe/Madrid). The dashboard shows all dates in this timezone.
Account.adminEmail ● String scalar
Main admin email, first set to the email of the user who created the account. Admin emails go to it when notifications.adminEmails is empty.
Account.apiKey ● String scalar
API key used to authenticate REST and GraphQL requests for this account. null unless the caller holds credentials:read.
Account.customDomain ● String scalar
Custom domain serving the hosted payment page.
Account.customDomainConfig ● CustomDomainConfig object
Custom domain DNS and certificate state.
Account.payoutTerms ● AccountPayoutTerms object
Settlement (payout) terms.
Account.business ● BusinessData object
Legal and operational details of the business.
Account.iban ● String scalar
IBAN where EUR settlements are deposited when payoutTerms sets no IBAN. Masked (first 2 and last 4 characters) unless the caller holds iban:read.
Account.bankAccount ● BankAccount object
Settlement bank account verification details.
Account.language ● String scalar
Account language: en, es, ca, pt, de, it or fr. Customer receipts and emails use it when the language of the customer is not known. MONEI emails and invoices to the merchant also use it. The dashboard calls it Customer language. Defaults to en.
Account.tokenizationMethods ● AccountTokenizationMethods object
Tokenization wallets configured for the account.
Account.notifications ● AccountNotifications object
Email notification preferences.
Account.billingPlan ● BillingPlans enum
Commercial billing plan.
Account.contract ● AccountContract object
MONEI services contract envelope.
Account.referralCode ● String scalar
Referral code of the affiliate that referred this account.
Account.promoCode ● String scalar
Promo code of the partner (master) account. Set at signup or by connectMasterAccount.
Account.allowCreateApiKey ● Boolean scalar
Whether the account may create API keys. Only the MONEI_POS billing plan reads it.
Account.previewFeatures ● [String!] list scalar
Preview feature flags enabled for this account.
Account.notConfiguredReason ● NotConfiguredReason deprecated enum
Use statusReason.
**Deprecated.** Not used. Always null. Use statusReason.
Account.notConfiguredNote ● String deprecated scalar
Use statusNote.
**Deprecated.** Not used. Always null. Use statusNote.
Account.userNote ● String scalar
Note from the merchant to MONEI compliance, sent with setupAccount, verifyBusinessDetails or requestAccountReview. Cleared when the account is approved.
Account.createdAt ● String! non-null scalar
Account creation time (ISO 8601).
Account.approvedAt ● String scalar
Date the account was first approved by compliance (ISO 8601). Later approvals do not change it.
Account.updatedAt ● String scalar
Date the account was last updated (ISO 8601).
Account.rejectedReason ● RejectedReason deprecated enum
Use statusReason.
**Deprecated.** Not used. Always null. Use statusReason.
Account.rejectedNote ● String deprecated scalar
Use statusNote.
**Deprecated.** Not used. Always null. Use statusNote.
Account.statusReason ● StatusReason enum
Reason for the current status.
Account.statusNote ● String scalar
Free-form note about the current status.
Account.fraudDetectorThreshold ● Int scalar
Fraud-detector score threshold (0-1000). Card payments scoring above this value are declined. 0 is lowest risk, 1000 highest. When null, payments are scored and none is declined. The dashboard (Settings > Fraud detector) shows it divided by 10.
Account.fraudDetectorEnabled ● Boolean scalar
Whether the fraud detector screens the card payments of the account. A fee is charged for each screened payment.
Account.accountManager ● AccountManager object
Dedicated MONEI Account Manager. null when the account has no dedicated Account Manager, the manager is inactive or has no contact email, or the lookup fails. [dashboard-only]
Returned By
account query ● connectMasterAccount mutation ● disableCustomDomain mutation ● disableTokenizationMethod mutation ● disconnectMasterAccount mutation ● enableCustomDomain mutation ● enableTokenizationMethod mutation ● requestAccountReview mutation ● requestOnlineChannel mutation ● setupAccount mutation ● startCompanyLookup mutation ● updateAccount mutation ● verifyBusinessDetails mutation ● verifyCustomDomain mutation