In certain cases your solution may require a merchant user to perform a certain action related to a particular transaction. For example, start a refund process or resolve a dispute. It can be achieved via a dynamic action button on a transaction page.
Toqio will request from the provider integration connector to pass dynamic button params if available. The response will include the information related to a dynamic action button - button text and workflow application url. It will enable you to set up any custom action related to a transaction.
The Get Dynamic button endpoint is responsible for retrieving the logic related to displaying an action button for a specific transaction.
GET
https://your_connector_url/customers/{customerId}/transactions/{transactionId}/dynamicButton
Path Params
customerId (Path Variable): The ID of the customer.
transactionId (Path Variable): The ID if the transaction
Response object
marketplaceKey(string), obligatory: This field represents the workflow application ID. Using this ID the button will redirect to the required workflow app.
texts(the array of strings), obligatory: This field will pass the text you want to display on the button in different languages.
If there is no button to show please send us an empty object.
The response allows us to decide whether to show the button to the user or not, and if shown to display the required text and facilitate the correct redirect to the required workflow application.
The Merchant user can access this feature on the transaction details page.
Please note that it is important to make sure that the workflow application is installed for the Customer. If the application is not installed, the button will not be shown.