---
title: "Hosted Fields | Standard Integration"
description: "Step-by-step guide to integrating KOMOJU Hosted Fields in standard mode — covering session creation, rendering payment fields on the frontend, and handling form submission."
url: "https://docs.priv.staging.komoju-dev.tools/en/docs/integration-guides/hosted-fields-standard-integration"
source_url: "https://docs.priv.staging.komoju-dev.tools/en/docs/integration-guides/hosted-fields-standard-integration.md"
language: en
last_modified: "2026-03-25"
---

This is a guide on how to add KOMOJU Fields to your checkout page. In this guide, you provide the full checkout experience, and use KOMOJU Fields for collecting payment right directly on your checkout page.

The overall flow of this integration method is to let Fields do all the work of collecting user input, sending it to KOMOJU, and redirecting the user on success.

![](https://files.readme.io/487cfa1-image.png)

# Step 1: create a payment session on backend

Before you can render payment fields, you must create a session with at least an amount and currency.

Save the `id` field and send it to your frontend.

# Step 2: use session ID to render fields on frontend

Once you have your session, you can render payment fields on your frontend.

You'll need 2 pieces of information:

1. Your session ID from step 1, and
2. Your publishable key from the KOMOJU merchant settings page.

```html
<script type="module" src="https://multipay.komoju.com/fields.js"></script>

<komoju-fields
  session-id={your_session_id}
  publishable-key={your_publishable_key}
></komoju-fields>

```

# Step 3: decide how you want users to submit

There are 2 ways to submit the fields:

1. Place your `<komoju-fields>` inside of a `<form>` element, and submit the `<form>` like normal, OR
2. Use JS to call `submit()` on your `<komoju-fields>` component: `document.querySelector('komoju-fields').submit()`.

It's important to note that in case 1, your form tag _does not actually get submitted_. KOMOJU Fields cancels the form's `submit` event, and directly POSTs the customer's payment details to KOMOJU.

On payment success, the customer will be redirected to your session's `redirect_url` regardless of whether you submit via form or via `submit()`.