Itsy Docs
Data

Payment Methods

Configure how customers pay for their bookings — bank transfers, credit cards, and online checkout providers.

Payment methods define the ways customers can pay for their orders. Each method is linked to a payment provider (or no provider for manual methods like bank transfers) and controls whether it appears on the customer portal, allows refunds, and accepts negative amounts.

How It Works

You create a payment method by choosing a provider, giving it a name, and configuring its behavior. When staff register a payment on an order, they select from the active payment methods. If a method is marked for customer portal use, it appears as a checkout option for customers booking online.

Key Concepts

Payment Providers

Each payment method is backed by a provider that determines how the payment is processed:

ProviderDescription
No External ServiceManual payment processing (e.g., bank transfers, cash, invoicing). Staff register payments manually.
Teya Payment PageRedirects customers to a Teya-hosted payment page for card payments
Stripe CheckoutRedirects customers to Stripe's hosted checkout for card payments
Rapyd CheckoutRedirects customers to Rapyd's hosted checkout
Internal Promo CodeUsed internally for promo code redemptions. Created automatically when you set up promo codes.

Payment Method Properties

PropertyDescription
NameDisplay name shown to staff and customers
DescriptionAdditional details about this payment method
ProviderThe payment processing provider (see above)
AttributesProvider-specific configuration (API keys, merchant IDs, etc.)
Allow Negative AmountWhether this method can process negative payments (credits)
Allow RefundsWhether refunds can be issued through this method
Used in Customer PortalWhether this method is available for online checkout
ActiveWhether the method is currently available

Customer Portal Payment

Only one payment method can be active on the customer portal at a time. When you mark a method for portal use, all other methods are automatically removed from the portal. This ensures customers see a single, clear payment option during checkout.

Automatic Payment Methods

When you create a promo code, Itsy automatically creates a payment method with the "Internal Promo Code" provider. This method is used internally to record promo code redemptions as payments. You don't need to create these manually.

Deletion Protection

Payment methods that have been used to process payments cannot be deleted. This preserves the audit trail for all historical transactions. You can deactivate unused methods instead.

Common Tasks

Setting Up a Card Payment Method

  1. Navigate to Data > Payment Methods
  2. Click Add
  3. Choose a provider (Teya, Stripe, or Rapyd)
  4. Enter the method name (e.g., "Credit Card")
  5. Configure the provider-specific attributes (API keys, merchant IDs)
  6. Enable Used in Customer Portal if customers should see this at checkout
  7. Enable Allow Refunds if you want to process refunds through this provider
  8. Click Save

Adding a Manual Payment Method

  1. Navigate to Data > Payment Methods
  2. Click Add
  3. Choose No External Service as the provider
  4. Enter the method name (e.g., "Bank Transfer" or "Cash")
  5. Click Save

Staff can then select this method when recording manual payments.

Changing the Portal Payment Method

  1. Open the payment method you want to use on the portal
  2. Enable Used in Customer Portal
  3. Save — all other methods are automatically removed from the portal

How It Connects

  • Promo Codes — Each promo code automatically creates an associated payment method.

On this page