Sorry, you need to enable JavaScript to visit this website.

Stop and Recall API

Version 5.0 Dev
APIs

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)

 

gpi Stop and Recall Overview

 

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

 

Q4 2021

  • Automatic stop and recall closure when the related payment is rejected

Q1 2022

  • Universal Case Management – Allow non-gpi BICs to subscribe to the Case Management service (embedding SRP and CASE capabilities)

  • Allow stop and recall requests to be triggered 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).

APIs

Developer Reference

Ready to take the API for a spin?

Use the developer references such as the OpenAPI specification, SDK and Postman collection to get started!

View SRP Reference

View Transaction Details Reference

Rulebook

Understanding the business rules are necessary when integrating with this API, be sure to reference the SRP rulebook.

View Rulebook

Please note that a newer version of the Stop and Recall Rulebook will be published in Q3 2021.

Versioning

gpi API release policy and versioning strategy respect a consistent and comprehensive policy.

View gpi Release Policy & Versioning

APIs

Get started with this API today

follow the step-by-step guide