Skip to main content

Schema Preview (Beta)

Any change to Nium's beneficiary schema like adding a new required field — goes live immediately on the release date as documented in the Nium Changelog. This gives you no time to adapt, which can cause payment failures, unexpected form changes for users, and urgent last-minute fixes.

We’re beta testing a Schema Preview endpoint that enables you to see and test upcoming schema changes.

Schema Preview​

You’ll be able to preview new or updated beneficiary fields (including required ones) before release in both sandbox and production environments.

With the Schema Preview, you can update your integration ahead of the actual release date to avoid any surprises.

No API changes are needed to use the Schema Preview — the preview works with your current integration and requests.

You can choose when to opt in or opt out of the Schema Preview (Beta) by contacting Nium Support.

Using the Schema Preview​

If the Schema Preview (Beta) is enabled for your account and currency, the beneficiary endpoint will return the updated version in advance of release but payments will get impacted only after release.

On the release date, the updated schema becomes the default for all clients.

This ensures you can transition smoothly, test thoroughly, and reduce payment failures.

  • No more sudden changes breaking your forms or causing failed payments.
  • Early visibility into upcoming mandatory fields or validations.
  • Controlled adoption — you decide when to start using the preview.

If you’d like to be part of the Beta Schema Preview for upcoming schema changes, please contact your Nium account manager or Nium support.