Go live and keep the EPP updated

Set debug mode

To help identify issues, the embedded payment page offers a debug mode that logs every operation to the console. Simply set debugMode: true.

import { Payment } from 'truelayer-embedded-payment-page'
const payment = Payment({
  payment_id: 'example-string',
  resource_token: 'example-string',
  return_uri: 'example-string',
  debugMode: true,

Go live

By default, the embedded payment page runs in a "sandbox" mode. That lets you test payments created with the sandbox environment of the Payments API.

When you’re ready to switch to production, start using the Payments API production environment, and simply switch the embedded payment page to production on initialisation production: true.

import { Payment } from 'truelayer-embedded-payment-page'
const payment = Payment({
  production: true

Keep the EPP updated

Embedded payment page broadly consists of two components. Updates for each are handled differently.

The on-screen elements and the payment flow are all hosted by TrueLayer. Any changes that we make here will be visible to your users straight away, without you having to make any updates.

The embedded payment page JavaScript package, which sets up the view, is downloaded from NPM and installed on your web page. From time to time we may make changes to how this component works, for example, if there are new parameters that you can pass on initialisation to configure the user flow. Once you've installed the latest embedded payment page version from NPM, you can take advantage of these changes.