> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://ixopay.ferndocs.com/developer-hub/documentation/reference/integration/hosted-fields-payment-js/overview/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://ixopay.ferndocs.com/_mcp/server.

# Hosted fields — payment.js

payment.js integration offers a secure way to accept card payments. It integrates card number and CVV/CVC input directly into your checkout process, avoiding the need for redirection to a separate payment form.

The library renders two separate iframes for card number and CVV/CVC on your checkout page. This efficient approach minimizes your PCI-DSS scope, reaching the lowest possible level with SAQ-A.

At the end of this JavaScript flow, a one-time `transactionToken` is generated, which identifies the customer's card. This token is then passed to the [Transaction API](https://documentation.ixopay.com/api/transaction/transaction-api) request.

> **Guide**
>
> For a detailed, step-by-step guide on integrating the payment.js, refer to the [payment.js guide](https://documentation.ixopay.com/docs/guides/getting-started/accept-payments/payment.js "Payment.js guide") in our guides section.

## Articles

In this section, you will find detailed information and resources to help you integrate and effectively utilize payment.js in your payment process with IXOPAY platform. Explore the following topics to gain insights into the implementation, benefits, and outcomes of payment.js:

#### [Method reference](https://documentation.ixopay.com/docs/reference/integration/payment.js/methods)

payment.js method reference covering init, tokenize, refreshCvv, enableAutofill, setNumberStyle, setCvvStyle, numberOn, cvvOn, and other hosted field APIs.

#### [Error codes](https://documentation.ixopay.com/docs/reference/integration/payment.js/error-codes)

payment.js error codes reference listing error attributes, keys, and messages returned by tokenize and refreshCvv callbacks for card validation failures.

#### [Event listening](https://documentation.ixopay.com/docs/reference/integration/payment.js/event-listening)

Reference for payment.js event listening, covering input, focus, blur, mouseover, enter, and tab events on hosted card number and CVV input fields.

#### [Advanced guides](https://documentation.ixopay.com/docs/reference/integration/payment.js/advanced-guides)

In-depth information on integrating our client-side API into your workflow.