Status Transitions

👍

tl;dr

Typically payables transition from pending -> processing -> initiated -> completed.
Payables in a completed state indicate a successful payment.

Unsuccessful payments will end in issue or failed and require support to intervene.

Changeable - Non-Processing

needs_approval

A payable in this state requires a user to take action on the payable in the Routable dashboard per your account's approval settings.

ready_to_send

A payable in this state requires either user action in the dashboard or an API call to move the payable into pending, canceled, or externally_paid

scheduled

A payable in this state will move to pending automatically on the date_scheduled

Unchangeable - Non-Processing

pending

A payable in this state requires vendor or customer action and will be automatically transitioned to processing when the required action is completed.

Depending on the scenario, it is possible to transition a payable in this state to either canceled or externally_paid by contacting [email protected]

Unchangeable - Processing

processing

A payable in this state is actively being processed

issue

A payable in this state indicates that there was an issue when trying to initiate the payment.

Please contact [email protected] and our support team can help restart the payment or move it into other final states (e.g. canceled or externally_paid).

initiated

A payable in this state has had the payment initiated with our banking partners

failed

A payable in this state has failed after initiating the payment.

Please contact [email protected] and our support team can help restart the payment or move it into other final states (e.g. canceled or externally_paid).

Final

canceled

A payable in this state has been canceled.

externally_paid

A payable in this state has been marked as externally paid.

completed

A payable in this state has been paid.