The Stop and Recall (SRP) APIs allow the rapid halting of payments that are suspected to have been made in error or in a fraudulent manner. The SRP request is used to stop and recall a transaction which is still in progress (where the funds have not yet been credited to the beneficiary account), or to request the recall of funds that were already credited to the beneficiary. The customer will return the funds in accordance with existing market practices.
To request the cancellation of a transaction, the requesting agent makes an API call to the gpi Tracker. The inflight transaction for which the requestor triggered a stop and recall will be stopped via the network, preventing any further processing of the payment. The gpi Tracker will also route the stop and recall request to the intermediary financial institution handling the payment at that moment. After stopping the payment, the institution can re-route the funds back to the payment originator before it is too late. The API call must be formatted in accordance with the Rulebook.
The Stop and Recall APIs include the below methods which enable:
-
SRP assigner to initiate a stop and recall (Cancel Transaction PUT API)
-
SRP assignee to respond to a stop and recall (Transaction Cancellation Status PUT API)
-
SRP users can then retrieve the status of their stop and recall requests via theTransaction Details APIs (Get Payment Transaction Details API / Get Changed Payment Transactions API)
Additional documentation can be found on the SWIFT Knowledge Center.
Supported Developer Toolkit
This API will be supported by SWIFT SDK and SWIFT Microgateway.
Roadmap
Q1 2022
-
Universal Case Management – Allow non-gpi BICs to subscribe to the Case Management service (embedding SRP and CASE capabilities)
-
Allow gpi users to initiate and respond to stop and recall requests on Financial Institution Transfers
Q2 2022
-
Push Notifications
Ordering and Provisioning
Become a gpi member and subscribe to the gpi Customer Credit Transfer (gCCT) service to start using the stop and recall APIs. Order now.
Note that as from next year, non-gpi institutions will also be able to subscribe to the Stop and recall service (cfr Universal Case Management initiative).