Manage payment methods

Save, update, and remove customer payment methods in the VINR vault.

View as MarkdownInstall skills

Saving a payment method to a customer record lets you charge them later without asking them to re-enter their details — essential for subscriptions, one-click reorders, and off-session charges. VINR vaults the payment method in its PCI-compliant secure storage; you store only the pm_... identifier.

The payment method vaultAsk

When a customer's payment method is saved, VINR stores the sensitive data (card number, expiry, etc.) and returns a reusable PaymentMethod ID. You attach this ID to a Customer record to associate it with a specific person.

Customer (cus_...)
  └── PaymentMethod (pm_...)   ← safe to store, reuse, and pass in API calls
        └── Card data          ← held in VINR's PCI vault, never exposed in the API

Never store raw card numbers. pm_... IDs are safe to store — they reference tokenized data held entirely in VINR's PCI-compliant vault.

Reusable vs single-use methodsAsk

Not all payment methods can be saved for reuse:

MethodReusableNotes
CardsYesCan be charged unlimited times after saving
SEPA Direct DebitYesRequires mandate acceptance at setup
iDEAL, BancontactNoSingle-use redirect; VINR generates a reusable SEPA mandate after the first use
Bank transfersNoEach transfer is a separate instruction
Meal vouchersNoPhysical voucher cards are not stored

In this sectionAsk

Was this page helpful?
Edit on GitHub

Last updated on

On this page