Stop a single payment

Stop Single Payments API allows businesses to request the cancellation of an existing single payout transaction that has already been submitted for processing.

This API is typically used when a payment needs to be stopped due to duplicate processing, incorrect beneficiary details, operational errors, or customer requests.

Cancellation requests are subject to bank processing rules and the current status of the payment. Successfully submitting a cancellation request does not guarantee that the payment will be stopped if it has already been processed by the bank.

Important information

This service is not supported for Single Instant Payments.
Stop Payment service is available only for Scheduled Payments and can be requested up to one day prior to the payment value date or scheduled execution date.

🌐
Domain details
Environment
Domain
Rate/Limit
Sandbox
sandboxapi.onesingleview.com
3 Calls per Minute
Production/LIVE
To be provided upon onboarding
Based on contract

Environment	Domain	Rate/Limit
Sandbox	sandboxapi.onesingleview.com	3 Calls per Minute
Production/LIVE	To be provided upon onboarding	Based on contract

Perform a stop payment operation

Endpoint details

Endpoint URL	Method	Authentication requirements
`/api/v2/cancel/payment/`	POST	`SVReferenceID` `CompanyId` `Device` `DateTimeStamp` `Authorization: Bearer`

Sample request

Stop Single Payment Request

curl --location 'https://sandboxapi.onesingleview.com/api/v2/cancel/payment' \
--header 'SVReferenceID: 29214008782670' \
--header 'CompanyId: SVUATAPIDASHBOARD' \
--header 'Device: web' \
--header 'DateTimeStamp: 2026-06-23T10:20:39' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjoiTDNyMmpxV29JS2I4MTNodDBNaVN4MzdCZHREWlNGdTFad3B5QnlkOVpHelZXR2ZwUmFQNUYrZzB5YVg5bi9KVE5wK1FucERJMEZXWWN6VGJsOEc5cXhaY0U2TXlZbmNtWWZFMzZkdlFpTTRXeVBNalQ2WG1NUDh5YXI4RDVWZTV5c3h3dDRFektqdjdyS2tqQkpJcGo0VmJNeFlLbG5aNHc0V1ArT2FIVzNCNzkrUT0iLCJpYXQiOjE3ODIyMTM3MzUsImV4cCI6MTc4MjIxNzMzNX0.7YieIyFLapyIJ8fBw8gROzH8OqOlN650yrgFQ9xDqaU' \
--header 'Content-Type: application/json' \
--data '{
"Message": {
  "OSVCancelPaymentRequest": {
        "TransactionType": "CANCEL",
        "BankCode": "SABB",
        "CompanyCode": "SVIEWUAT",
        "CancelReason": "Cancel Payment 29214008782670",
        "ReferenceNumber": "29214008782670",
        "BankReferenceNumber": "B260108143421114"
      }
},
"Signature": "szYN7DooWZFfnblL7isLasWXmOM/H3iWmHW04nAhAVTeXFyubbN/ztRT8d9h/uMU69YCNEmBiHYgiJswgyERUuY+JeaV0rdaEojjq0NAKojB3A0pqAINiVEa4hJLSpJYiSZwjDLYAbYWdOsaUSgzE6MgDuQHPRZc7qxD3ngUh9DtwKSkivpItAhhkQttqIyxntHVghGPzmtN/WAECcY9NN9ZrK8l31gLmxDb/BCjqh0wSXRgk9MNAWBmucamBeCzNCtQLIc3j0RUQTf4rBPeMgi7qf/2L66d+0Hpr4TzlHkmyn4deo+GxjgYEKqc0xP28PXsyvV6UKuWKmpEM+fTiA=="
}'

Request parameters

JSON Tag	Requirement	Description	Data type
OSVCancelPaymentRequest	Mandatory	Root node containing the stop payment message	Object
TransactionType	Mandatory	Details of the transaction type to be mentioned as `CANCEL`	String
BankCode	Mandatory	Unique bank identification code `SABB` - Saudi Awaal Bank `ANB` - Arab National Bank `GIB` - Gulf International Bank	String
CompanyCode	Mandatory	Sender company code or identifier provided by the bank at the time of on-boarding	String
CancelReason	Mandatory	Details about the reason for cancellation of the payment	String
ReferenceNumber	Mandatory	Unique identification number of the payment requested for cancellation	String
BankReferenceNumber	Conditional Mandatory for ANB	Unique bank identification details of the payment	String
Signature	Mandatory	Encrypted string generated using a Private Key/CA-Signed Certificate with SHA-256 and RSA (JCE Signature)	String

Sample response

Stop Single Payment Response

{
  "OSVCancelPaymentResponse": {
    "TimeStamp": "2026-06-23T10:20:39",
    "BankCode": "SABB",
    "CompanyCode": "SVIEWUAT",
    "ReferenceNumber": "911068939506634",
    "BankReferenceNumber": "B260108143421114",
    "StatusCode": "Failed",
    "StatusDetail": "Client Certificate is not Matched"
  }
}

Response parameters

JSON Tag	Description	Data type
OSVCancelPaymentResponse	Tag carrying information on stop payment process response	Object
TimeStamp	Time denoting the fetching of response for the stop payment process	Date
BankCode	Unique bank identification code `SABB` - Saudi Awaal Bank `ANB` - Arab National Bank `GIB` - Gulf International Bank	String
CompanyCode	Sender company Code/Identifier	String
ReferenceNumber	Unique tracking identification number of the payment request	String
BankReferenceNumber	Unique bank identification details of the payment	String
StatusCode	Code representing status of the transaction in the request	String
StatusDetail	Details of the status code represented for the transaction in the request	String

Status Codes & Information

StatusCode	StatusDetail
Completed	Payment stopped successfully.
Failed	Bank response description
Response_Timeout	Timeout! Unable to get response from the bank. Please try later or contact SingleView support.

Categories

GENERAL INFORMATION

GETTING STARTED

AUTHENTICATION

Data APIs

Payment APIs

SADAD

RESOURCES

API Archives

Domain details

Perform a stop payment operation

Endpoint details

Sample request

Sample response

Status Codes & Information