Flow Automation: Triggering Workflows When a Dispute Is Created
You can use the New dispute trigger in Flow Automation to automatically start a workflow when a new payment dispute is created in your store. For example, a customer might file a chargeback with their card-issuing bank, or the acquirer might ask you to provide transaction documents. With this trigger, you can notify your team right away, tag the related orders, and avoid missing the deadline to submit evidence.
This guide explains the actions supported by this trigger, the dispute types it recognizes, and how to handle payment disputes automatically through a real-world scenario.
| Note: Before using this trigger, make sure your store has activated SHOPLINE Payments and your account has permission to manage payment disputes. |
Supported Actions
The following actions are primarily used in workflows initiated by the New dispute trigger:
- [General] Send email
- [Order] Update order tags
- [Order] Add order tags
- [Customer] Add customer tags
Dispute Types
The New dispute trigger recognizes the following four dispute types. You can add a Dispute type condition to your workflow so that it only runs for specific types of disputes:
| Dispute type | Description | |
| CHARGEBACK | The customer has disputed the transaction with their card-issuing bank, and the bank is holding the disputed amount. | |
| PRE_CHARGEBACK |
An early stage before a full chargeback, while the card-issuing bank investigates the dispute.
|
|
| RETRIEVAL | The acquirer is asking you for more information or supporting documents about the transaction. | |
| FRAUD_NOTIFIACTION | Indicates that the transaction may involve fraud. |
Example Use Case
Here is a practical example of using the New dispute trigger to respond quickly to retrieval requests.
Scenario: When the acquirer opens a retrieval request for transaction documents, automatically notify your customer service team to collect the documents, and tag the order.
- Trigger: New dispute
- Condition: Dispute type equals to RETRIEVAL
-
Action 1: Send email
- Subject: [Retrieval Notice] Please submit transaction documents within the required time frame.
- Content: Please submit transaction documents within the required time frame.
- Recipient: Manually enter your customer service team member’s email address
-
Action 2: Update order tags
- Order number: [Order number]
- Order tags: Awaiting retrieval evidence
- Outcome: As soon as your store receives a retrieval request, your customer service team is notified and the order is tagged, so they have time to prepare shipping proof and other documents before the evidence deadline.
| Note: To insert the information shown in square brackets (such as the order number), click + Add variables and select the corresponding parameter. |