Create Manual Payment Request

Manual Payment Requests: Overview

The Manual Payment Request is the primary method for initiating transactions within our system. This streamlined process combines a standard request flow with optional fields for deeper customisation.

We offer two environments for processing Requests. To ensure your integration is seamless, we recommend performing a Test Request before moving to the Live environment, where actual funds are transferred.

Required steps

  1. Navigate to the Transactions tab and click Create Payment.

  2. Choose between Test or Live request types.

file-lines

Test runs are entirely safe and involve no real financial movement.

  1. Select your preferred Checkout configuration. If you haven't created one, the system should automatically apply the Default Checkout.

  2. Enter the Amount and select the Currency.

  3. Click Create Payment to generate the Request.

Optional steps

  1. You may include a Descriptor by entering it in the corresponding field. This short note appears on the Customer’s financial statement and helps clarify the nature of the charge.

  2. Enter a Base reference ID if required, or manually provide an Origin reference ID:

    • The Base reference ID is used when an order is split into multiple payments, ensuring all payments share the same ID.

    • The Origin reference ID is a unique identifier linked to your account.

circle-info

If these fields are left empty, the system generates the IDs automatically.

Details

This section contains all textual and visual content that can be displayed on the Checkout page, provided that the selected theme supports these elements.

  • You can add a visual representation of the product by entering the image URL in the corresponding field. This image should be shown to the Customer during Checkout.

  • To provide additional details about the purchased product, enter its Title and a Description with the relevant information.

Customer

This section contains information about the Customer involved in the Payment Commit. Please note the following:

  • You can create a Payment Request without specifying a Customer.

  • If Customers have already been added to the system, you can select one from the existing list. Click Select existing and choose the Customer from the dropdown.

  • If needed, you can create a new Customer by clicking Create from fields and entering the required details. You may also manually provide a Reference ID for the Customer. If no unique ID is specified, the system generates it automatically. For more details, refer to the Create a Customer guide.

Flow options

Workflow

Feature
Description

Payment type

  • Direct payment stands for the final debiting of funds directly during the Transaction.

  • Verify payment focuses on verifying payment details or reserving funds for future use. The money is not debited immediately.

Expires at

  • Set the specific time after which the payment link should expire and cannot be used. Enter the time number in the corresponding field.

  • The value should be greater than 61. If you decide to skip this field, the system should fill it in automatically with the default value, which equals 15 minutes.

Tokenise

Tokenisation is storing sensitive payment account data (mainly card data) by assigning it a public key, a Token that can then be used as an alternative to sensitive data.

Thus, you can store the token on your side, linking it to the Customer corresponding Payment account. You can use the Token for recurrent payments, for example.

  • Click the Tokenise toggle to initiate the process.

Processing

Feature
Description

Commits limit

You can select the number of allowed Commits within the given Request.

  • Choose the available number or create a Custom one. The precondition is that the Value must be greater than or equal to 10 and less than or equal to 1. When you create a request via the Dashboard, the default Value equals 1.

Auth auto retry

The option helps to avoid technical issues while the system is initiating multiple attempts to perform a payment.

  • Click Auto retry to enable blocking prevention.

  • Click Cancel to leave the process as it is.

Metadata

Metadata contains additional information that provides useful details about the created Payment Request.

  • To add Metadata, enter a Key and its corresponding Value in the corresponding fields.

  • To include another pair, click Add a new key.

Last updated