Merchant Configuration
The Merchant Configuration page lets you set account-wide defaults that apply to all payments. Individual payment requests can override these defaults, but the values you configure here are used when no override is provided.
To open this page, go to Settings > General in the Odus Dashboard.
You can also read and update the same settings via the API — see GET /merchant-configs and POST /merchant-configs/:id.
Dashboard settings
These settings control how data is displayed in the Odus Dashboard. They do not affect payment processing.
Display currency
The currency used when showing aggregate amounts in reports and statistics. Select any supported currency from the dropdown. This setting does not convert or affect the currencies charged to your customers.
Timezone
The timezone used for all reporting, scheduling, and subscription billing windows. Timezones are listed in IANA format (for example, Europe/Paris or America/New_York). If not set, Odus defaults to UTC.
Changing the timezone affects when subscription renewals are grouped and when delayed captures trigger. Review your active subscriptions before changing this setting.
Default payment settings
These settings define the default capture behaviour for all payment methods. You can override them per payment method type using the sections described below.
Capture method
Controls when funds are captured after a payment is authorized.
| Value | Behaviour |
|---|---|
automatic | Funds are captured immediately at authorization. |
manual | Funds are not captured automatically. You must call the capture endpoint explicitly. |
automaticDelayed | Funds are captured automatically after the number of days set in Capture delay. |
Capture delay
Visible only when Capture method is set to automaticDelayed. Enter the number of days after authorization before the automatic capture triggers. The valid range is 1–5 days.
Recurring capture method
The capture method applied to subscription renewal charges. By default it inherits the value from Capture method. You can override it independently if recurring charges require different behaviour.
Recurring capture delay
Visible only when Recurring capture method is automaticDelayed. The delay in days before recurring charges are auto-captured. The valid range is 1–5 days.
Recurring payment bundling
When enabled, same-day subscription renewal charges for the same customer are grouped into a single payment instead of separate charges. This reduces transaction fees and simplifies billing statements.
See Payment Bundling for bundling criteria, failure behaviour, and examples.
Card payment settings
Tick Set Card payment settings to expand card-specific overrides.
Processing mode
| Value | Behaviour |
|---|---|
cascade | Odus routes the payment through the selected cascade rule. |
direct | Odus sends the payment directly to the selected gateway profile. |
Default cascade
Visible when mode is cascade. Select the cascade rule to apply to card payments by default.
Default gateway profile
Visible when mode is direct. Select the gateway profile to use for card payments by default.
Card capture method and delay
Per-payment-method override for the capture settings described in Default payment settings. If set to Use default, the root default applies. Capture delay for cards is 1–5 days.
Card recurring capture method and delay
Same as above but for subscription renewal charges on cards.
PayPal payment settings
Tick Set PayPal payment settings to expand PayPal-specific overrides.
PayPal always uses direct mode. You must select a gateway profile that supports PayPal.
PayPal gateway
The gateway profile used for all PayPal payments. Only profiles that support PayPal are shown.
PayPal capture method and delay
Same options as the default capture settings. Capture delay for PayPal is 1–15 days.
PayPal recurring capture method and delay
Capture settings applied to PayPal subscription renewal charges.
Apple Pay payment settings
Tick Set Apple Pay payment settings to expand Apple Pay-specific overrides.
Apple Pay always uses direct mode. You must select a gateway profile that supports Apple Pay.
Apple Pay gateway
The gateway profile used for all Apple Pay payments. Only profiles that support Apple Pay are shown.
Apple Pay capture method and delay
Same options as the default capture settings. Capture delay for Apple Pay is 1–5 days.
Apple Pay recurring capture method and delay
Capture settings applied to Apple Pay subscription renewal charges.
Saving changes
Click Update to save all changes. The button is disabled until all required fields are valid.