Sign in
Customers

Update an Associated Barcode's payment method

Links a PaymentMethod to the given barcode (or unlinks the current one). When a payment method is attached, charges captured via the barcode — typically wristband-based "post-pay" purchases at a spa or resort — are funded from that saved card rather than requiring the guest to present payment at every till.

Pass payment_method_id: null to detach the current payment method; subsequent tap-to-charge attempts on the barcode will then be declined or routed to a manual-pay flow depending on the site configuration.

The chosen PaymentMethod must belong to the same customer and pass server-side validation against the underlying processor (for card methods that means the card has to still be valid on the customer's processor profile). The change is recorded in the customer audit log under updated_barcode_payment_method.

put/customers/customers/{customerId}/barcodes/{barcodeId}/payment-method

Request body

payment_method_idstring nullable required

Identifier of a stored PaymentMethod belonging to the same customer, used as the default charge target when this barcode is presented at point-of-sale. For card methods the card must still be valid on the underlying processor profile. Pass null to detach the current method.

Example request

{
  "payment_method_id": "5e1e3f6c-2a44-4f6e-8c61-9c1f7d2e1c11"
}

Response

The associated barcode was successfully retrieved

Changes

No recorded changes to this endpoint across all 1 revision of this API.