Account Settings
Basic settings
Section titled “Basic settings”Find these in Settings → Account:
| Setting | Description |
|---|---|
| Name | Biller display name |
| Account contact email | |
| Phone | Contact phone number |
| Address | Registered business address |
| Timezone | Used for scheduling and reporting (IANA format, e.g. Australia/Sydney) |
| Currency | ISO 4217 — set at account creation, not changeable after activation |
| Country | ISO 3166-1 alpha-2 |
Payment settings
Section titled “Payment settings”Configure how fees are calculated and which payment methods are accepted:
| Setting | Description |
|---|---|
txn_fee_cents |
Flat fee per transaction in cents |
fee_rate_bps |
Percentage fee in basis points (100 bps = 1%) |
surcharge_enabled |
Whether surcharges are passed to customers. Each payment method must also be enabled for surcharging; see Surcharging by payment method |
fee_cap_cents |
Maximum fee per transaction in cents |
fee_minimum_cents |
Minimum fee per transaction in cents |
To toggle accepted payment methods (card, BECS direct debit), use the Payment Methods section in account settings.
Surcharging by payment method
Section titled “Surcharging by payment method”surcharge_enabled is the account-wide switch. With it on, a payment method is
surcharged only when that method is also enabled for surcharging, with
payment_method_rates.<method>.surcharge_enabled set to true. For example,
payment_method_rates.card.surcharge_enabled covers card payments and
payment_method_rates.au_becs_debit.surcharge_enabled covers BECS direct
debits. A method that isn’t enabled is never surcharged, so you can surcharge
card payments but not direct debits, or the reverse.
Card payments on Australian accounts are never surcharged, even when cards are enabled. See Card payments.
Customer attribute config
Section titled “Customer attribute config”Define custom fields that appear on every customer record for this account. See Custom Attributes for configuration details.
Lifecycle actions
Section titled “Lifecycle actions”| Action | From state | Effect |
|---|---|---|
| Activate Live | pre_activation |
Starts compliance review |
| Suspend | active |
Pauses payment processing, including scheduled payments, which are held; requires a reason |
| Reinstate | suspended |
Returns account to active; held scheduled payments are sent on the next run, including any whose date has passed |
| Deactivate | Any | Permanently closes the account |