Payment Cards
Payment cards let you collect payments from your customers’ credit and debit cards. The platform currently supports Stripe as the card payment provider. Once set up, you can collect payments automatically when invoices are due, or collect individual payments manually.
The platform does not collect or store card numbers. Customers supply their card details to Stripe, and the platform holds only a reference to the Stripe payment method. All sensitive card data remains with Stripe.
Adding a Payment Card
Section titled “Adding a Payment Card”Customer Self-Service (Recommended)
Section titled “Customer Self-Service (Recommended)”The easiest way to add a payment card is to send the customer a payment link. They enter their card details directly through Stripe’s secure form, and the card appears on their record automatically. See Sending Payment Links below.
Manual Addition
Section titled “Manual Addition”To add a card manually:
- View the customer’s record
- Go to Add menu > Payment Card
- Enter the card details:
- Cardholder Name: The name on the card
- Card Type: Visa, Mastercard, or other supported type
- Last Four Digits: The last four digits of the card number
- Expiry Date: The card’s expiry date
- Card Storage Method: Set to Stripe for provider-managed collection
- Card Collection Order: The priority for this card when the customer has multiple cards. 1 is collected first.
- Use For Collection: Which collection types this card can be used for (manual, automatic, or both)
- Use For Payment Types: Restrict to specific payment types, or leave blank for all types
- Click Save
Stripe Provider Fields
Section titled “Stripe Provider Fields”When using Stripe, you also need to supply:
- Provider Customer Reference (required): The Stripe customer ID (beginning
cus_) - Provider Reference (recommended): The Stripe payment method ID (beginning
pm_). If you leave this blank, the platform will automatically use the customer’s most recent card in Stripe for any collection.
The other provider fields (Provider Key, Provider Token) are updated automatically when the platform syncs with Stripe, for example when a webhook is received or a scheduled update runs. You do not need to fill these in yourself.
Important: If you are adding cards through your own Stripe integration rather than the platform’s payment links, make sure the Stripe request is configured to allow future payments on the card. Without this, the platform will not be able to collect against it.
Sending Payment Links
Section titled “Sending Payment Links”You can send customers a link to add their card or make a payment without needing a portal login.
Via the Actions Menu
Section titled “Via the Actions Menu”- View the customer’s record
- Go to Actions menu > Generate Payment Links
- The system generates a no-login URL for card payment
- Copy the link and send it to the customer
The customer follows the link and enters their card details through Stripe’s secure payment form.
Via Correspondence
Section titled “Via Correspondence”You can include payment links in billing emails and other correspondence. The platform provides template variables that insert the correct URLs automatically. See Correspondence Workflows for details on setting up templates with payment links.
Finding Customers Who Need a Card
Section titled “Finding Customers Who Need a Card”To chase up customers for card details, you need a list of those who should be paying by card but cannot be collected from. The platform builds this list for you.
Go to the main menu > Payment Cards > View / Edit Payment Cards. The list opens on the Missing Cards tab.
Why the Missing Cards Tab Is the Chase-Up List
Section titled “Why the Missing Cards Tab Is the Chase-Up List”Missing Cards shows active customers whose payment method is set to card collection, but who have no usable card. This means the customer either has no payment card at all, or every card they have is Expired or Invalid.
These are exactly the customers to chase. You can then send each one a payment link to add a fresh card.
This is different from filtering customers by payment method. That filter finds customers whose payment method has been changed to something else. The Missing Cards tab finds customers who are still on card collection but have nothing valid to collect against.
The Other Tabs
Section titled “The Other Tabs”The same view has five tabs:
| Tab | Shows |
|---|---|
| Missing Cards | Active card customers with no usable card. This is the chase-up list. |
| Recently Added | Cards added in the last 30 days |
| All Cards | Every payment card across all customers |
| Active Cards | Cards ready for collection (Active or Confirmed) |
| Inactive Cards | Cards that can no longer be used (Expired or Invalid) |
See Card Status for what each status means.
Spotting It on the Customer Record
Section titled “Spotting It on the Customer Record”You do not have to rely on the list to catch these customers. When you view an active customer who is set to card collection but has no usable card, the platform shows a warning in the page title: Customer has no valid payment card details.
Downloading the List
Section titled “Downloading the List”Each tab can be exported. Open the tab you want, then go to View/Download menu > Download CSV. This gives you a spreadsheet to work through, share with a colleague, or hand to another team for the chase.
The download includes the customer account numbers. You can copy that column and paste it straight into the Bulk Mailing tool, so you chase every affected customer in one go rather than opening each record. See Bulk Correspondence.
Payment Collection
Section titled “Payment Collection”Manual Collection
Section titled “Manual Collection”To collect a specific payment by card:
- View the payment record
- Go to Actions menu > Collect from Card
- Select which payment card to use
- The system submits the charge to Stripe
Automated Collection: On Delivery
Section titled “Automated Collection: On Delivery”The system can create and submit a card payment automatically when an invoice is emailed, printed, manually delivered, or downloaded by the customer through MyAccount.
When triggered by delivery, the system collects the current due balance for the delivered invoice.
This behaviour is controlled by system parameters. Contact your system administrator to enable or adjust delivery-triggered collection.
Automated Collection: Time-Based
Section titled “Automated Collection: Time-Based”The system can also create card payments on a schedule based on invoice due dates:
- Create: The system creates the payment a set number of working days before the invoice due date
- Submit: The system submits the payment to Stripe a set number of working days before the due date
Your system administrator can adjust these timings to suit your billing cycle.
Card Status
Section titled “Card Status”Payment cards have four statuses:
| Status | Meaning |
|---|---|
| Active | Card is ready for collection |
| Confirmed | Card verified by Stripe; key fields are now read-only |
| Expired | Card has passed its expiry date |
| Invalid | Card has been declined or is otherwise unusable |
Status Actions
Section titled “Status Actions”- Mark Expired: Change an active card to expired status
- Mark Invalid: Flag a card as declined or problematic
- Mark Current: Return an expired or invalid card to active status
Field Locking
Section titled “Field Locking”Once a card reaches confirmed status, the following fields become read-only to protect the verified details:
- Cardholder Name
- Card Type
- Last Four Digits
- Expiry Date
- Card Storage Method
- Provider Token, Provider Customer Reference, Provider Reference, Provider Key
To update these details, the customer should add a new card via a payment link.
Payment Status
Section titled “Payment Status”Card payments move through these stages:
- Pending: Payment created, waiting to be submitted to Stripe
- Processing: Submitted to Stripe, awaiting confirmation
- Collected: Payment received successfully
- Failed: Charge was declined or unsuccessful
Failed payments include the provider’s decline code for troubleshooting. Common reasons include insufficient funds, expired cards, and bank-declined transactions.
If automatic collection fails or no eligible card exists, the system creates a TODO alerting you to the issue.
Card Fields
Section titled “Card Fields”The fields below make up a payment card record. Sensitive card data is held securely by the payment provider, not the platform.
Payment Card References
Section titled “Payment Card References”This section contains reference numbers used to identify the payment card across systems, including internal references, customer references, and card priority settings for collection order.
| Field | Description |
|---|---|
| Our Reference | Internal reference number for the payment card |
| Customer's Reference | Customer-provided reference for the payment card |
| Card Collection Order | Priority order for payment collection when customer has multiple payment cards |
Card Details
Section titled “Card Details”Card Details contain the payment card information including cardholder name, card type, last digits, expiry date, storage method configuration, collection settings, and provider-specific references for payment processing integrations.
| Field | Description |
|---|---|
| Email Address | Email address associated with this payment card |
| Cardholder Name | Name of the cardholder for the payment card |
| Card Type | Type of payment card (e.g., Visa, Mastercard) |
| Last Four Digits | Last four digits of the payment card number for identification |
| From Date | Start date for the payment card validity period |
| Expiry Date | Expiry date of the payment card |
| Card Storage Method | Method used to store and process the payment card information |
| Use For Payment Types | Payment types this payment card can be used for |
| Use For Collection | Types of payments this payment card can be used to collect |
| Provider Token | Token assigned by the payment card provider |
| Provider Customer Reference | Customer reference used by the payment card provider |
| Provider Reference | Reference number assigned by the payment card provider |
| Provider Key | Provider key for payment card processing |
Status
Section titled “Status”The Status section displays current card status information including setup dates, payment collection history, and card lifecycle timestamps.
| Field | Description |
|---|---|
| Card Status | Current status of the payment card |
| Set-Up Date | Date when the payment card was set up with the provider |
| Last Taken Date | Date when a payment was last successfully taken from this card |
System Information
Section titled “System Information”System-generated information including modification timestamps and activity tracking for administrative purposes.
| Field | Description |
|---|---|
| Last Modified | Timestamp of the most recent modification to this payment card |
| Created | Timestamp when this payment card was created |
Managing Cards
Section titled “Managing Cards”Multiple Cards
Section titled “Multiple Cards”A customer can have more than one payment card. The Card Collection Order field controls which card the system uses first for automatic collection. Set 1 for the primary card, 2 for the backup, and so on.
Replacing a Card
Section titled “Replacing a Card”When a customer’s card expires or is replaced:
- Send them a new payment link to add the replacement card
- Once the new card is confirmed, mark the old card as expired
- Update the Card Collection Order if needed
The old card remains on the customer’s record for audit purposes.
Want automated card payment collection built into your billing workflow? see how SAFE Billing Platform automates payment collection via Stripe