loader

How to create a custom payment processor

Payment Processors ยท Updated 08 Jul 2026

Custom payment processor package

Create a ZIP package with a manifest.json, a service class, logo assets and optional configuration schema.

{
  "name": "Example Gateway",
  "slug": "example-gateway",
  "version": "1.0.0",
  "module_type": "third_party",
  "credential_schema": {
    "sandbox": [{"name": "public_key", "label": "Public key", "type": "text"}],
    "live": [{"name": "live_public_key", "label": "Live public key", "type": "text"}]
  },
  "settings_schema": [{"name": "locale", "label": "Locale", "type": "select", "options": ["auto", "en", "de"]}]
}

After upload, configure sandbox/live credentials in admin, activate the gateway, then verify that it appears in checkout.