Overview: Settings

View as Markdown

Configure your PaymentKit account settings to customize branding, billing behavior, notifications, and more.

Account settings

Access settings through the dashboard sidebar under Settings.

Brand & Identity

Customize how your business appears to customers:

SettingDescription
Company nameYour business name shown on invoices and checkout
LogoDisplayed on hosted pages, emails, and invoices
Primary colorBrand color used in checkout and portal
Support emailContact email shown to customers
Support URLLink to your help center or support page

Upload a high-resolution logo (at least 512x512px) for best results across all devices and email clients.

Custom domain

Use your own domain for hosted pages:

  1. Navigate to Settings > Custom Domain
  2. Enter your desired subdomain (e.g., pay.yourcompany.com)
  3. Add the provided DNS records to your domain
  4. Wait for verification (usually within an hour)

Once configured, your checkout and portal URLs will use your custom domain instead of paymentkit.com.

Business details

Configure your business information for invoices and tax compliance:

FieldDescription
Business addressYour registered business address
Tax IDVAT, GST, or other tax identification number
Default currencyPrimary currency for new prices
Default timezoneUsed for reports and scheduled operations

Billing settings

Invoice settings

Configure default invoice behavior:

SettingDefaultDescription
Invoice numberingSequentialNumber format (e.g., INV-0001, INV-0002)
Invoice prefixINVPrefix for invoice numbers
Footer textEmptyCustom text shown at bottom of invoices
Payment termsDue immediatelyDefault days until payment is due

Dunning behavior

Configure what happens when payments fail:

BehaviorSubscriptionInvoiceDescription
Cancel and mark uncollectibleCancelledUncollectibleDefault - clean break
Cancel and keep openCancelledOpenPursue collection externally
Keep past due and mark uncollectiblePast DueUncollectibleMaintain service, write off debt
Keep past due and keep openPast DueOpenMaintain service, continue collection

Email settings

Email notifications

Configure which emails are sent to customers:

EmailDefaultDescription
Invoice createdEnabledWhen a new invoice is generated
Invoice paidEnabledPayment confirmation receipt
Payment failedEnabledNotification when payment fails
Subscription createdEnabledWelcome email for new subscriptions
Subscription cancelledEnabledConfirmation of cancellation
Trial endingEnabledReminder before trial period ends

Email templates

Customize the content of customer emails:

  1. Navigate to Settings > Email Templates
  2. Select the template to customize
  3. Edit the subject line and body content
  4. Preview and save changes

Use template variables like {{customer_name}} and {{invoice_total}} to personalize emails.

Checkout settings

Payment methods

Enable the payment methods available at checkout:

  • Credit/debit cards - Visa, Mastercard, Amex, etc.
  • Digital wallets - Apple Pay, Google Pay
  • Bank payments - ACH, SEPA (where supported)
  • Buy now, pay later - Klarna, Afterpay (where supported)

Available payment methods depend on your connected payment processors and their capabilities.

Checkout options

SettingDescription
Allow promotion codesLet customers enter discount codes
Collect billing addressRequire full billing address
Collect shipping addressRequire shipping address (for physical goods)
Terms and conditions URLLink to your terms (shown at checkout)

Team settings

Team members

Invite team members to access your PaymentKit account:

  1. Navigate to Settings > Team
  2. Click Invite Member
  3. Enter their email and select a role
  4. They’ll receive an invitation email

Roles and permissions

RolePermissions
OwnerFull access, can manage billing and delete account
AdminFull access except account deletion
DeveloperAPI keys, webhooks, and test mode
SupportRead-only access, can issue refunds
ViewerRead-only access

API settings

API keys

Manage your API keys:

  • Create new keys - Generate secret and publishable keys
  • Rotate keys - Create new keys while keeping old ones active
  • Revoke keys - Immediately disable compromised keys

Always use separate API keys for test and production environments. Never share secret keys.

Webhooks

Configure webhook endpoints to receive event notifications:

Test mode

Toggle between test and live modes at the top of the dashboard:

ModeDescription
Test modeUse test API keys, process test payments
Live modeUse live API keys, process real payments

Always test your integration thoroughly in test mode before going live. Test mode data is separate from live data.


[MBCC]