> For the complete documentation index, see [llms.txt](https://help.alternativepayments.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.alternativepayments.io/getting-started/account-set-up-and-configuration/white-labeling-your-payments-portal.md).

# White-labeling your Payments Portal

**Add custom branding so your customer payment portal looks like an extension of your brand.**

***

White-labeling your payment portal takes just 30 seconds! Follow the steps below and provide your customers with a fully-branded payment experience:

1. Log in to your Alternative portal: [app.alternativepayments.io](https://app.alternativepayments.io/)
2. Click [**Team Preferences**](https://app.alternativepayments.io/dashboard/team/preferences) and then select [**Preferences > Branding**](https://app.alternativepayments.io/dashboard/team/preferences?pageTab=branding)**.**
3. Upload your company logo from your computer by clicking on "Choose a file."
4. Next, add your main brand color by inputting the hex code or click on the circle and select a color using the color wheel.
5. Once you click "Save", the updates will be complete.
6. Navigate to the "Accounts Receivable" section, click on your billing link and paste it into your browser to see the changes.

<figure><img src="https://1567070316-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKPl2XyqKMY0CU5Sb4EWy%2Fuploads%2F5MavwHt1CrqQsNWwu8pk%2FScreen%20Shot%202024-12-03%20at%2010.22.00%20AM.png?alt=media&amp;token=1a1f1bc7-6b41-40ee-9f79-93c0e14bfc77" alt=""><figcaption></figcaption></figure>

### Logo Upload

When you click "Choose a file," the portal opens an **"Adjust your image"** dialog where you can crop and zoom your logo before saving. Use the zoom slider or the **+** / **−** buttons to scale the image, then drag the crop handles to frame the area you want displayed. Click **Apply** to confirm, or **Use another image** to start over with a different file.

**No minimum width requirement.** Logos of any width can be uploaded — the previous 200 px minimum width restriction has been removed.

**Square logos may appear smaller in the portal frame.** Because the portal display area is wider than it is tall, a square logo occupies less of the horizontal space than a wide rectangular logo would. If your logo looks smaller than expected, use the zoom control in the "Adjust your image" dialog to expand it and fill more of the frame before clicking **Apply**.

**Brand color renders as entered.** The hex code or color-wheel value you save is displayed exactly as you set it in your portal. Only the button hover state applies a slight darkening effect — the base color itself is no longer altered.

### Help Page

Under [**Preferences > Help page**](https://app.alternativepayments.io/dashboard/team/preferences?pageTab=help), you can configure a custom support email address and phone number that are displayed on the customer-facing help page.

### Payment Methods

Under [**Preferences > Payments**](https://app.alternativepayments.io/dashboard/team/preferences?pageTab=payments), you can choose which payment options are visible to your customers (ACH, credit card, or Pay in Installments).

#### Debit Card Acceptance

By default, Alternative Payments accepts debit cards alongside credit cards. Debit card acceptance is controlled by a **global, partner-level setting** — it applies to all customers under your account simultaneously and cannot be toggled on or off for individual customers.

If you would like to block debit cards, contact your Customer Success Manager or reach out to <customersuccess@alternativepayments.io> to request the change. Once the block is enabled, any card the system identifies as a debit card will be declined at checkout, and your customers will see the message: *"\[Your business name] doesn't accept debit cards. Add a credit card instead."*

**Important fee implication:** When debit cards are accepted, the processing fee is always absorbed by the partner. A debit card is charged at its card network's rate, the same as the credit equivalent: 2.9% + $0.30 for Visa, Mastercard, and Discover. Unlike credit card fees, debit card processing fees cannot be passed through to the end customer. Before requesting a change to this setting, make sure you have reviewed and accepted this cost.

### Custom Domains

If you want your billing link to use your own domain (e.g., `pay.yourcompany.com`), contact your account executive or reach out to <customersuccess@alternativepayments.io>.

Congratulations! You're ready to start offering your customers a fully branded and flexible payment experience. If you have any questions, reach out our team at <customersuccess@alternativepayments.io>.

**Love our platform?** Rate us on [Channel Program](https://channelprogram.com/v/alternativepayments) and check out our [Referral Program page](https://www.alternativepayments.io/referral-partners/)!


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.alternativepayments.io/getting-started/account-set-up-and-configuration/white-labeling-your-payments-portal.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
