Session Customization

Overview

When creating a payment, payment link, or subscription offer, you can customize the checkout page that your customers see. This lets you maintain a consistent brand experience throughout the payment flow.

Available Options

Property	Type	Description	Example
`bgColor`	string	Background color of the checkout page	`"#ffffff"`
`fontColor`	string	Font color on the checkout page	`"#000000"`
`logoUrl`	string	URL of your brand logo	`"https://yoursite.com/logo.png"`
`merchantName`	string	Your business name displayed on checkout	`"Your Brand"`

How to Use

Via the API

Include the sessionCustomization object when creating a payment, link, or subscription offer:

Payment:

curl -X POST https://api.inflowpay.xyz/api/checkout/payment \
  -H "X-Inflow-Api-Key: inflow_priv_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "products": [{ "name": "Product", "price": 4999, "quantity": 1 }],
    "currency": "EUR",
    "customerEmail": "[email protected]",
    "sessionCustomization": {
      "bgColor": "#1a1a2e",
      "fontColor": "#ffffff",
      "logoUrl": "https://yoursite.com/logo-white.png",
      "merchantName": "Your Brand"
    }
  }'

Payment Link:

curl -X POST https://api.inflowpay.xyz/api/link \
  -H "X-Inflow-Api-Key: inflow_priv_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Premium Plan",
    "products": [{ "name": "Premium Plan", "price": 9999, "quantity": 1 }],
    "sessionCustomization": {
      "bgColor": "#ffffff",
      "fontColor": "#333333",
      "logoUrl": "https://yoursite.com/logo.png",
      "merchantName": "Your Brand"
    }
  }'

Subscription Offer:

curl -X POST https://api.inflowpay.xyz/subscription/offer \
  -H "X-Inflow-Api-Key: inflow_priv_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Pro Plan",
    "description": "Monthly pro access",
    "amountInCents": 2999,
    "currency": "EUR",
    "interval": "month",
    "intervalCount": 1,
    "sessionCustomization": {
      "bgColor": "#0f172a",
      "fontColor": "#e2e8f0",
      "logoUrl": "https://yoursite.com/logo-light.png",
      "merchantName": "Your Brand"
    }
  }'

From the Dashboard

When creating a payment link or subscription offer from the Dashboard, you'll find the customization options in the creation form. You can also set default branding in your Settings > Business Info page (logo and business name).

Default Behavior

If no sessionCustomization is provided, the checkout page uses:

Your business name from Settings
Your logo from Settings
Inflow's default colors

Notes

The logoUrl must be a publicly accessible HTTPS URL.
Colors should be valid hex codes (e.g., #ffffff, #0070F3).
Per-payment customization overrides your default business settings.
These options apply to the hosted checkout page only. For SDK card form styling, see Styling & Customization.