> For the complete documentation index, see [llms.txt](https://docs.peakcommerce.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.peakcommerce.com/product/using-peakcommerce/payments-and-payment-methods/hosted-pages.md).

# Hosted Pages

### Overview

Hosted Pages allow for customers to send payment details (such as providing a credit card) to purchase a company's product or put on file for recurring payments or update an existing payment method. It ensures that the payment gateways set up in the integrated billing system are also used in PeakCommerce.

To view and configure Hosted Pages, navigate to Payments > Hosted Pages. Hosted Pages can be added, edited or deleted. See the example below.

#### Adding a Hosted Page

To add a hosted page click the “Add Payment Page” button in the upper right corner.

### Components

A description of each field can be found in the order they appear when creating a hosted page.

**Hosted Page**

This field has dropdown options that include the Hosted Pages previously set up in the billing system. Select the Hosted Page of choice and the next three fields will auto-fill accordingly.

**Page Name**

This field is automatically filled with the same name from the billing system. However, it may be changed to have a different name displayed in PeakCommerce.

**Type**

This field is automatically filled in when the hosted page is selected. This information is taken from the billing system.

**Version**

This field is automatically filled in when the hosted page is selected. This information is taken from the billing system.

**Partner Admin**

This field is no longer in use.

**Payment Gateway**

This field has dropdown options that include the payment gateways already set up in the billing system. This field is **required.**

**Hosts**

This field is not required.

### Assigning Hosted Page to Profile

#### USD Currency

To assign a Hosted Page to a Profile first navigate to User > Profile. Under Profiles, choose the desired profile and click "Edit".

Navigate to the Configurations tab. Locate the section called Hosted Payment Page at the top. Select a Hosted Page from the dropdown list corresponding to the Type of Payment Method: Credit Card, ACH, SEPA, or Direct Debit. **For each type of payment method, there must be a different hosted page.**

**Example:**

If adding an ACH Hosted Page, go to the Configurations tab, and add the proper ACH HP to the field labeled "ACH Hosted Payment Page ID" from the dropdown options.

This profile must also have the following two permissions set to enable use of ACH.

**Pay Invoices**

* For customers to pay invoices using ACH, the Pay Invoices with ACH setting must be must be marked "Full" on the Pay Invoices tab. See below.

**Payment Method Permission**

* For customers to be able to view the ACH payment methods they have on file, add a new ACH payment method to their account, edit existing ACH payment methods on their account, or do all of the above, the ACH Payment Method Permission on the My Account tab must be marked accordingly: View, Create, Edit, or Full. See below.

### Foreign Currency

To assign a Hosted Page to a Profile first navigate to User > Profile. Under Profiles, choose the desired profile and click "Edit".

Navigate to the Currencies tab. Choose the proper currency tab. Locate the section called Hosted Payment Page at the top. Select a Hosted Page from the dropdown list corresponding to the Type of Payment Method: Credit Card, ACH, SEPA, or Direct Debit. **For each type of payment method, there must be a different hosted page.** Do not make any changes to the Configurations tab for foreign currency Hosted Pages.

**Example:**

If adding a Direct Debit Hosted Page, go to the Currencies tab, click the GBP tap, and add the proper Direct Debit HP to the field "DirectDebitUK Hosted Payment Page ID" from the dropdown options.

This profile must also have the following two permissions set to enable use of Direct Debit.

**Pay Invoices**

* For customers to pay invoices using Direct Debit, the Pay Invoices with Direct Debit UK setting must be must be marked "Full" on the Pay Invoices tab. See below.

**Payment Method Permission**

* For customers to be able to view the Direct Debit payment methods they have on file, add a new Direct Debit payment method to their account, edit existing Direct Debit payment methods on their account, or do all of the above, the Bank Transfer Payment Method Permission on the My Account tab must be marked accordingly: View, Create, Edit, or Full. See below.


---

# 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:

```
GET https://docs.peakcommerce.com/product/using-peakcommerce/payments-and-payment-methods/hosted-pages.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
