Payment Actions are only available on select connections. Please reach out to [email protected] or your customer success manager to confirm availability for your connection.
A payment_action is an object that represents additional actions or instructions that should be sent to the bank regarding a specific payment (e.g. a payment_order) that is distinct from the payment initiation instruction.
| Attribute | Description |
|---|---|
| id string | Unique identifier for the payment order |
| live_mode boolean | This field will be true if this object was created with a production API key or false if created with a test API key. |
| actionable_id string | The id of the payment to action on. Optional, but if present, the actionable_type must also be present. |
| actionable_type string | The type of the payment being actioned on. One of payment_order, expected_payment. Optional, but if present, the actionable_id must also be present. |
| type string | The type of action decision for this specific payment action. The possible actions are determined based on the of the actionable. |
| status string | The status of the payment action. One of pending , processable, processing,sent,acknowledged failed, cancelled |
| details object | The action specific attributes of the payment action. |
Payment Action Types for each Payment Types
currently we only support positive pay actions forcheck type payments
| Payment Type | Possible Action Types | Description |
|---|---|---|
check | stop | Send a payment action notification to stop the corresponding check payment. |
issue | Send a payment action notification to issue the corresponding check payment (also known as Positive Pay). This is a notification to the bank that the corresponding check has been printed outside of the bank and should be honored. |
Payment Action State Machine
The diagram below describes the changes and dependencies of the payment action state machine.
When the Payment Action is associated to an actionable of type payment_order, the payment action state is dependent on the state of the Payment Order. For other actionable types, such as expected_payment, the payment action state is not dependent on the state of the EP.
The following abbreviations are used to make rendering the diagram easier:pa is payment_action and po is payment_order. actionable refers to a type of payment that payment actions can be run on, specifically a payment_order.
Actionable State Matrix
The following describes the states of a payment action alongside the possible states for the corresponding actionable
| Payment Action Status | Payment Order Status |
|---|---|
pending | pending,needs_approval,approvedprocessing |
processable | sent |
processing | sent |
sent | sent |
acknowledged | stoppedcompleted |
failed | sent,completed |
cancelled | failed,cancelled |