Settings

My Account

Everything about your own subscription: what you pay, when you pay it, and what you have paid so far.

Last updated 2026-10-13

DigitalKey ERP — Docs · digital-key.co/docs/settings/my-account

Overview

Balance and subscriptions are held per user, not per business. This screen is about you specifically — a colleague's balance and features are their own.

My Account — My Account screen
My Account screen
My Account screen — Balance and monthly cost at the top, with subscribed features and billing history below.
NoteMy Account is also where the business's settings live — team and permissions, invoice and PO print settings, currency, workflow, the activity log and the recycle bin each have a tab here. See Settings Overview. This page covers the first tab.

Billing information

GET /api/v1/billing/my-info
ParameterTypeRequiredDescription
usernamestringOptionalYour sign-in name.
full_namestringOptionalYour display name.
lifecycle_statusstringOptionalYour account state — registered, active, temp_suspend, suspend or deactivated.
balancedecimalOptionalWhat is left in your account, in IQD.
billing_dayintegerOptionalDay of the month you are billed on, fixed at first login.
last_billed_atdateOptionalWhen you were last billed.
next_billing_atdateOptionalWhen the next deduction is due.
first_login_attimestampOptionalWhen you first signed in.
status_changed_attimestampOptionalWhen your lifecycle state last changed. Grace periods count from here.
monthly_totaldecimalOptionalTotal monthly cost of everything you subscribe to.
features[]arrayOptionalEach subscribed feature with its own monthly price.
ImportantThe number that matters is balance against monthly_total. If the balance will not cover the monthly total by next_billing_at, the deduction fails and a grace period starts. Check this before the date, not after. All of these figures are in Iraqi Dinar, whatever your business's main currency is.

Your subscribed features

Each feature you are subscribed to is listed with its monthly price. Together they make up monthly_total.

NoteFree features — pos.quick_sale is the only one — appear in the list but add nothing to the total. A user with only free features is still billed on schedule; the deduction is simply zero, and the billing dates still advance.

Deduction history

GET /api/v1/billing/my-deductions
ParameterTypeRequiredDescription
deduction_idintegerOptionalIdentifier.
feature_namestringOptionalWhich feature was charged for.
feature_keystringOptionalThe feature key.
amountdecimalOptionalAmount deducted, in IQD.
period_monthdateOptionalThe month being paid for.
statusstringOptionalsuccess, failed_low_balance or free.
deducted_attimestampOptionalWhen the deduction ran.
WarningA row with status failed_low_balance is a missed payment. It marks the start of a grace period — see Lifecycle States for what happens next and how long you have.

Top-up history

GET /api/v1/billing/my-topups
ParameterTypeRequiredDescription
topup_idintegerOptionalIdentifier.
amountdecimalOptionalAmount added, in IQD.
topped_up_by_rolestringOptionalWhether an admin or a reseller added it.
payment_methodstringOptionalHow it was paid, when recorded.
notesstringOptionalAny note left with the top-up.
created_attimestampOptionalWhen it was credited.
NoteYou cannot top up your own balance from inside the ERP. Balance is added by a platform administrator or by your reseller — contact whoever set your account up.

Profile

Your name, email, phone and profile photo can be changed here, and your password changed from the same screen.

Profile endpoints
ParameterTypeRequiredDescription
GET /auth/profileendpointOptionalRead your profile.
PUT /auth/profileendpointOptionalUpdate name, email and phone.
POST /auth/change-passwordendpointOptionalChange your password.
POST /auth/profile/photoendpointOptionalUpload a profile photo.

Related