Skip to main content

​
Overview

To process payments with Payrails, first you need to configure your workflow. Each workflow consists of Payment options step and a Routing step (optionally also a Retry step)

​
Organization and workspaces

Your Payrails account is divided into organization and workspaces contexts, with workflow configurations available within each workspace. Organization and workspace context

​
Workflow version

To access the workflow version page, log in to the Payrails Portal, choose your workspace, and click the Workflows → Payment Acceptance menu item in the sidebar. The workflow versions page will show you a history of workflow versions, with the version used for all new workflow executions marked as “Default” at the top.
When a new workspace is created, a new empty version of the payment acceptance workflow is also automatically created - a version 1. Workspace version 1 To create a new version of the workflow:
  • use the “+ New version” option whenever you want to create a new configuration starting from the scratch, without any previously configured steps
  • use “Edit as new version” if you want to configure a new version base of the already existing configuration. It will copy the settings and allow you to make minor (or big) changes.
Every time you want to change a workflow version, for example payment options visibility or routing rules, you will need to create a new workflow version using one of the above options. Regardless of your choice to create a new version or edit from an existing version, the first step of configuring a new workflow version is to give it a description. This is optional, but a well-described version is more easily identified in the future. Workflow version description

​
Next steps

Once you’ve added your Description, you will see a “New version configuration” page, where you can start configuring your Payment options or Routing rules. Each step will be labeled as:
  • “Required for payment execution” - if it has not been yet configured (for example, if you configure an entirely new version using “+ New version”)
  • “Unsaved changes” - if you added or updated your configuration but haven’t saved it yet
  • “Configured” - if the changes have been added and saved or if you are starting your configuration from an existing version using “Edit as new version”
Once you’ve finished configuring your workflow and saved it, you will see that the new version has been created. In order to use it for your execution, set it as Default. After you do it, you will see who and when set the workflow version as a default.
Last modified on September 30, 2026