Payment modules

Opayo

Opayo is a payment provider module used by Formie payment flows.

Notes

  • Payment providers also participate in the generic formie:payment:authorize:* events documented on the main events page.

Events

The formie:payment:provider-authorize:before event

Triggered before the active payment provider performs its authorization step.

js
document.addEventListener('formie:payment:provider-authorize:before', (event) => {
  // Filter provider-level work when you only care about one payment provider.
  if (event.detail.provider?.handle === "opayo") {
    console.log('Preparing provider authorization:', event.detail.provider);
  }
});

The formie:module:opayo:init event

Triggered after the provider module has initialized and is ready to manage provider-specific UI.

js
document.addEventListener('formie:module:opayo:init', (event) => {
  // Useful when you need to know the provider UI has mounted.
  console.log('opayo module init:', event.detail);
});

The formie:payment:opayo:challenge event

Triggered when opayo requires a provider-specific challenge step before submission can continue.

js
document.addEventListener('formie:payment:opayo:challenge', (event) => {
  // Handle the provider-specific follow-up step.
  console.log('opayo challenge required:', event.detail);
});
Last updated: May 6, 2026, 3:46 PM