Payment Source

PropertiesCopy Anchor Link

ObjectCopy Anchor Link

{
  "$id": "https://api.sb/kilnbakery.com/payment-sources/payment_source_1",
  "$type": "PaymentSource",
  "kind": "card",
  "label": "Visa 4242",
  "expiresOn": "2026-10-22",
  "default": true,
  "removedAt": "2026-10-22T12:00:00Z"
}

RelationshipsCopy Anchor Link

• A Payment Source is saved by one Customer: a Customer saves the Payment Sources its Orders, Subscriptions and Invoices charge; each belongs to one Startup and never moves to a sibling. savedBy, inverse saves.

VerbsCopy Anchor Link

1. getReturns one Payment Source by id.
   GET /{namespace}/payment-sources/{id}readNo Event
2. listReturns Payment Sources, newest first, one page at a time.
   GET /{namespace}/payment-sourcesreadNo Event
3. updateChanges the given properties of a Payment Source.
   PATCH /{namespace}/payment-sources/{id}doPaymentSource.updated
4. addAdd saves a new Payment Source for a Customer through Stripe’s embedded form on the Startup’s Domain, and can make it the default.
   POST /{namespace}/payment-sources/adddoPaymentSource.added
5. removeRemove detaches a saved Payment Source so nothing charges it again, and keeps the record.
   POST /{namespace}/payment-sources/{paymentSource}/removedoPaymentSource.removed

PermissionsCopy Anchor Link

Which Access level may call each Verb. One-way Verbs wait their delay window.

Call itCopy Anchor Link

Add the latest payment source with a customer.

ExampleCopy Anchor Link

A clinic on shiftnote.app saves a card ending 4242 as its default Payment Source and a bank debit as a backup. When the card expires, its renewal fails, and adding a new card in the Portal pays the open Invoice at once.