Creating Customers
Required fields
| Field | Notes |
|---|---|
| Name | Full name |
| Valid email address |
Optional fields
| Field | Notes |
|---|---|
| Reference | Your internal identifier — max 60 chars, unique per account |
| Business name | Trading name if different from contact name |
| Billing email | Separate email for invoices and receipts |
| Timezone | IANA timezone — defaults to account timezone if blank |
| Currency | ISO 4217 — defaults to account currency if blank |
| Phone (mobile) | With country code |
| Phone (home) | With country code |
| Phone (work) | With country code |
| Billing address | Country, line1, line2, city/suburb, state/region, postal code |
| Shipping address | Same structure as billing address |
Notification preferences
| Preference | Description |
|---|---|
send_payment_emails | Send email receipts for successful payments |
send_sms_reminders | Send SMS reminders before scheduled payments |
send_sms_failures | Send SMS notifications on payment failure |
SMS notifications require a valid mobile phone number.
Fee preferences
| Preference | Description |
|---|---|
customer_pays_transaction_fees | Pass transaction fees to the customer |
customer_pays_setup_fee | Charge a setup fee on plan creation |
These override the account-level fee settings for this customer.
Consent
The Authorised checkbox records that the customer has given consent for direct debit or recurring payments. Checking this field sets the consent_authorised_at timestamp. This timestamp is set once and is never overwritten on subsequent edits.
Adding a payment plan on creation
Enable the Set up payment plan toggle during customer creation to add a plan and collect a payment method in the same flow.
Custom attributes
If your account has custom attributes configured (see Custom Attributes), they appear at the bottom of the form. Required attributes must be filled in before saving.