# Embedded Payments

Render a Deluxe-hosted payment panel directly within your application.

Embedded Payments is a JavaScript SDK-based checkout option that lets developers render a Deluxe-hosted payment panel directly inside a merchant, partner, or ISV application.

It is designed for teams that want payment acceptance to feel like a native part of their application while using Deluxe-provided payment components, event handlers, JWT-based configuration, tokenization, payment method controls, and optional programmatic payment initiation.

### When to Use Embedded Payments

Embedded Payments is designed for applications that require a payment experience that feels like a natural part of the customer workflow.

Common scenarios include:

- Rendering a payment experience directly within a web or mobile application
- Supporting SDK callbacks for transaction success, failure, cancellation, or validation events
- Configuring how the payment panel is displayed and managed
- Generating tokens for downstream payment workflows
- Supporting cards, ACH, and other configured payment methods through a single checkout experience


### How Embedded Payments Works

Generate a signed JWT containing transaction and customer information.

Load and initialize the Embedded Payments SDK.

Render the payment panel within a designated application container.

Configure supported payment methods and display options.

Collect payment information using the Deluxe-hosted payment experience.

Receive payment results and transaction events through SDK callbacks.

Use returned payment artifacts or transaction results in downstream payment workflows.

### Key Capabilities

**Seamless application experience**

The payment panel renders inside the application so customers do not have to leave the workflow to complete checkout.

**SDK-based implementation**

Developers initialize the JavaScript SDK, pass configuration, and render the panel into a defined container.

**JWT-driven transaction context**

Transaction amount, customer data, payment method options, and feature settings are securely passed through a signed JWT.

**Event-driven payment handling**

Integrations can respond to transaction success, failure, cancellation, and validation errors through SDK event handlers.

**Configurable payment methods**

Integrators can display credit card, ACH, or both when those methods are enabled for the merchant account.

**Optional advanced capabilities**

Eligible merchants may use features such as tokenization, cryptogram generation, surcharging, partner fees, wallet status checks, and card brand logo configuration.

### Common Use Cases

**Embedded SaaS Checkout**

A SaaS platform renders the Embedded Payments panel directly inside its billing or checkout workflow. Customers complete payment without leaving the software experience, and the application receives transaction results through SDK event handlers.

**Customer Portal Payments**

A customer signs into a portal to pay an invoice, update payment details, or complete a service payment. Embedded Payments keeps the payment experience inside the authenticated portal while the SDK manages rendering and transaction event handling.

**Invoice and Bill Payment Workflows**

A billing platform embeds the payment panel next to invoice details, allowing customers to review the amount due and submit payment in the same interface. This workflow supports invoice payment screens, bill-pay pages, and account balance payment experiences.

**Token Generation for Future Payments**

An application uses Embedded Payments in token mode to collect payment credentials and receive a token. The token can be stored and used with a token-based payment API without storing raw payment information in the application database.

**Configurable Payment Method Display**

A merchant or partner configures the checkout panel to show credit card, ACH, or both depending on enabled merchant account capabilities and the desired checkout experience. Invalid payment method values are ignored, and mismatches between configuration and merchant enablement may result in an error.

### Next Step

Continue to the [**Embedded Payments Implementation Guide**](/products/merchant-services/developer-resources/developer-guide/emb-pay-integration) to learn how to:

- Generate and sign JWTs
- Load and initialize the Embedded Payments SDK
- Render and configure the payment panel
- Handle payment lifecycle events and SDK callbacks
- Configure supported payment methods
- Test and validate your integration