Adding custom fields to capture more payment information
How do I add fields to send additional custom values to Paytia and a payment gateway? Note: Custom fields is an additional licence. If you require this please contact sales@paytia.com Paytia has now introduced Custom fields as an additional licence ...
How do I add fields to send additional custom values to Paytia and a payment gateway?
Note: Custom fields is an additional licence. If you require this please contact sales@paytia.com
Custom fields are stored in Paytia transaction logs and where possible sent as additional metadata fields to the associated payment gateway.
Adding Custom fields
From the merchant portal find the Configure user screen menu and then the Data-capture sub-menu, from there you will be able to see the Custom field section.
Using the Add button you can create your own custom fields that are accessible to use over Paytia API services and also from inside the agent ACA screen.
Add
Description of how the fields work
| Field Name * | This is a required value. It allows you to add a text label to your new field |
| Placeholder Name * | This is a required field. It allows you to write the text form users will see when they use the field in the Paytia Agent Capture Assist interface. |
| Required/Not Required | It allows you to set if this field must be completed or not by your form users |
| Hide/Show | Controls if the field is hidden from the user form. Hidden fields can still be passed to logs and the payment gateway (where supported) |
| Data type | It allows you to set the expected data type so data is rejected if it is not found to be entered in the correct data format |
| Maxlength | Sets the maximum number of characters (including spaces) the field can hold |
| Field control | Controls if the data captured is retained in Paytia logs only, sent to the payment gateway or stored in both locations |
| Payment gateway field | Shows the field on the payment gateway this value will be sent into |
Once you have created a new field Paytia will automatically create a 'slug'. The slug is the field name as it would be sent to Paytia over an API post.
Example showing 'slug' value
API posting
From the API you would add the slug as a body field name.
Postman example
Agent Capture Assist form use
Your new custom fields will be added to the form view below the last system field of 'Account number' and before the system field of 'Payment type' selection.
Once you have all your fields added you are ready to start using the enhanced form service.
More in Configuration
Can I have more than one merchant ID?
Adding Multiple Merchant IDs to the Agent Capture Assist Form Agent Capture Assist enables businesses to process payments for multiple Merchant IDs under the same payment gateway. This functionality provides flexibility for businesses managing ...
Can I send my customer a payment receipt?
Sending a Customer Payment Receipt Using Paytia Paytia allows you to email payment receipts directly to customers after a successful transaction. Follow these steps to activate and use the payment receipt functionality. 1. Setting Up the ...
Can we add account numbers?
Adding multiple account numbers and linking them to the payment gateway The Account number sections allow our merchants to build up two part account numbers i.e. our account number always start ACC then they continue either 001, 002, 003 or CC1. The ...
Controlling the International dial prefix on Paytia telephone numbers
Controlling the international dial prefix for phone numbers is available in the Settings > International dial prefixes sub-menu. This control page allows you to quickly add any country you want to use on the Paytia platform for inbound call divert or ...
Create and manage Campaign eForms
Campaign eForms Overview The Manage Campaigns feature enables merchants to create and manage targeted campaigns for donations and payment collections. This functionality is available through two license options: Single Campaign Management: Create ...
Editing your contact details
Editing your contact details The Contact details section of the Paytia administrative portal allows you to change the information for the following settings 1. The primary email address on your account. This is the email address you signed up with ...
Still need help?
Our support team is here to help. Submit a ticket and we'll get back to you within one business day.