---
title: 'The JForm File'
url: 'https://manuals.remository.com/payage-dev/adding-a-new-gateway/the-jform-file'
markdown: 'https://manuals.remository.com/payage-dev/adding-a-new-gateway/the-jform-file.md'
date: '2026-11-14'
description: 'This file controls the appearance of the Payage account configuration form. The JForm file must be named .xml, where is the type of the addon declared in the Joomla manifest file. The file name must be lower case. The following fields are always available ("common_data"): Field Description …'
taxonomy:
  category:
    - docs
---

[](#) [ edit this page](https://github.com/getgrav/grav-skeleton-rtfm-site/blob/develop/pages/05.adding-a-new-gateway/06.the-jform-file/docs.md) 

# The JForm File

This file controls the appearance of the Payage account configuration form. The JForm file must be named .xml, where  is the type of the addon declared in the Joomla manifest file. The file name must be lower case.

The following fields are always available ("common\_data"):

| Field | Description |
|---|---|
| account\_name | Required. Every account must have a name. |
| account\_email | Optional. If your gateway requires an email address your model must enforce this in its check\_post\_data() function. |
| account\_language | Optional. |
| account\_currency | Required. Every account must have a currency. |
| button\_image | Required. |
| button\_title | Required. |
| button\_class | The class(es) for responsive buttons. |
| button\_text | The text for responsive buttons. |
| button\_icon\_1 | The left icon for responsive buttons. |
| button\_icon\_2 | The right icon for responsive buttons. |
| account\_description | Required. This is the text that may be used by applications to help customers decide which payment button to use. |
| account\_group | Required. |
| fee\_type fee\_amount fee\_min fee\_max | Optional. If no fee fields are defined, accounts for this gateway will not be able to charge a fee. |

You can add any additional fields required by your gateway configuration, but you must include them in your initData(), getPostData(), and check\_post\_data() functions.

 [ ](https://manuals.remository.com/payage-dev/adding-a-new-gateway/the-model) [](https://manuals.remository.com/payage-dev/adding-a-new-gateway/language-files)

---

## Navigation

- Parent: [Adding a New Gateway](https://manuals.remository.com/payage-dev/adding-a-new-gateway.md)
- Previous: [The Model](https://manuals.remository.com/payage-dev/adding-a-new-gateway/the-model.md)
- Next: [Language Files](https://manuals.remository.com/payage-dev/adding-a-new-gateway/language-files.md)