Pre-fill payment fields

​The Console allows you to pre-fill fields in payment and payout requests directly through URL parameters. It offers a pragmatic solution for optimizing the Request To Pay & Request For Payout creation workflow.
​
Whether you are focused on saving time, reducing errors, or seamlessly integrating with external systems, this feature provides a versatile and efficient solution.
​

Benefits

1. Time-Saving: the ability to pre-fill all the RTP and RFP fields directly through URL parameters significantly expedites the payment request creation process within the Console. Users experience a notable time reduction as manual data entry becomes unnecessary.
2. Efficient User Experience: the pre-filled fields allow for a seamless user experience, reducing the number of steps required to create a payment request to only one.
3. Error Reduction: using pre-fill forms minimize the risk of errors in payment requests by ensuring accurate and consistent data. It enhances the reliability of payment information, reducing the chance of discrepancies.
   ​

Usage in Integrations

​
The pre-filled RTP / RFP feature is particularly useful for integrations with custom applications and platforms, or for testing the RTP / RFP in sandbox. It is a lot easier to integrate than using the REST API, and allows creating payments in seconds.

Building the URL

Technical Details

To pre-fill the RTP and RFP forms within the Console, you need to construct a URL with query parameters providing the values for the fields you want to pre-fill. The URL must be constructed as follows:
​

1. First comes the base URL:
   • RTP: https://console.fintecture.com/create-payment
   • RFP: https://console.fintecture.com/request-for-payout
2. Then, for each field you want to pre-fill:
   - Add a ? if it is the first field, or a & if it is not the first field
   - Add the field name, followed by =, followed by the value you want to pre-fill
   - Ensure proper encoding of the value using encodeURIComponent to handle special characters and spaces.
   ​

Example in JavaScript

// Define payment details like amount
const amount = encodeURIComponent('42.00');
// Ensure proper encoding using `encodeURIComponent` to handle special characters and spaces.
const reference = encodeURIComponent(reference);
​
// Construct the URL with encoded parameters
const baseUrl = "https://console.fintecture.com/create-payment";
const url = `${baseUrl}?amount=${amount}&reference=${reference}`;
​
// Redirect or use the generated URL as needed
window.location.href = url;

Fields

All fields are optional. If a field is not provided, the user will be required to fill it manually and won't be able to submit the form until it is filled.
​
Note: once the payment request or payout is created, when requesting to create a new one the query parameters won't be reused and the form will be blank.
​

Request to pay fields

The following fields of the RTP form can be pre-filled.
​
Note that if a field is provided for a payment method that does not support it, the parameter will be simply ignored.
​

​

Request for payout fields

​
The following fields of the RFP form can be pre-filled.
​