Customize the payment page
Make the hosted payment page look like yours. Theme tweaks to a fully customized checkout built for your account.
The hosted page ships with MintCash's default look: clean and neutral. If you want it to feel like yours, the checkout is completely customizable. There are two ways to do it, depending on how far you want to go.
Option 1: Theme it
Keep the current layout and skin it — colors, fonts, spacing. Your merchant account carries a theme that we apply to every session automatically, full-page and embedded alike:
saveCardEnabled.| Knob | What it does | Accepted values |
|---|---|---|
accentColor | Buttons, focus states, and the card fields' highlights | Hex color (#0a7d4f, 3–8 hex digits) |
background | The page background behind the payment panel | Hex color |
font | Font family for the whole page | A font-family list, e.g. "Inter", sans-serif |
padding | Inner padding of the payment panel | Integer pixels, 0–48 |
inputBackground | Background of the input fields — secure card entry and billing address alike | Hex color |
inputTextColor | Text color of the input fields; placeholder and focus ink are derived from it | Hex color |
labelColor | Color of the field names above the inputs (card and billing alike) | Hex color |
accentTextColor | Ink on accent surfaces — the pay button's text and the checkbox checkmark | Hex color |
textColor | Body text — the save-card label, dividers, headings, and status/result copy | Hex color |
inputBorderColor | Border of the input fields and the checkbox (card and billing alike) | Hex color |
errorColor | Validation messages and invalid-field borders (card and billing alike) | Hex color |
Some knobs travel as pairs in practice: the defaults assume a dark page, so a merchant setting a light inputBackground should set a dark inputTextColor with it — otherwise the default light-gray text lands on a light field. The same goes for accentColor and accentTextColor (a light accent wants dark ink on the button, a dark accent wants light ink), and for a light background with a dark textColor.
Building a light theme? This recipe is a good start:
{
"background": "#ffffff",
"accentColor": "#e8756b",
"accentTextColor": "#ffffff",
"textColor": "#10151e",
"labelColor": "#10151e",
"inputBackground": "#ffffff",
"inputTextColor": "#10151e",
"inputBorderColor": "#10151e",
"errorColor": "#b3261e"
}Send your values to your account manager — our tech team applies them on your merchant account, usually within a couple of hours. There's nothing to pass on POST /payments, and changes apply to new sessions immediately.
Two properties worth knowing:
- Invalid values never break the page. Each knob is validated before render; anything that doesn't pass (a non-hex color, an out-of-range padding) is silently dropped and the default is used instead.
- Card entry always wins. The secure card fields are themed to match your accent — but if the themed form ever fails to initialize, the page falls back to the default-styled (dark) card form rather than blocking payment, while the rest of the page stays themed.
The Apple Pay and Google Pay buttons are the exception: their look is controlled by Apple and Google, so the theme doesn't touch them.
Option 2: Full custom checkout
If a theme isn't enough, we can release a checkout completely customized for your account, based on a design you provide — your layout, your components, your flow. The integration contract doesn't change: it's the same redirectUrl, the same iframe embed and postMessage events, the same webhooks.
Which one do you need?
If your brand is a color, a font, and a logo on your own page around the frame, the theme gets you there in hours. Reach for the full custom checkout when the layout itself has to change.
See also
- Accept a one-time payment — the hosted page flow this customizes
- Accept a payment with a saved card — charging without showing a page at all