Cancel transaction

This method handles transaction cancellation within the Balad Remit system.

Cancellable Transactions

Only the following transaction statuses can be cancelled. Each status results in either an Instant Cancel (Code 7) or Under Cancellation (Code 22) depending on the case.

Transaction Status Code	Transaction Status	Transaction Type	Resulting Status
0	Created	All	7 (Cancelled)
2	In Progress	Cash	22 (Under Cancellation)
8	Pending	All	7 (Cancelled)
11	Balad Compliance Suspended	All	7 (Cancelled)
12	Balad Compliance Approved	All	7 (Cancelled)
16	Bank Compliance Suspended	Cash	22 (Under Cancellation)
19	Ready For Pickup	Cash	22 (Under Cancellation)

Cancellation Reasons

Use one of the following values in the reason field when submitting a cancellation request.
If none of the predefined reasons apply, set reason to 13 and include your explanation in other_reason.

Code	Reason
1	I entered the wrong recipient name
2	I entered the wrong account, wallet, or phone number
3	I chose the wrong bank, wallet, or payout method
4	I entered the wrong amount
5	I no longer need to send this transfer
6	The recipient no longer needs the money
7	This is a duplicate transfer
8	The transfer is taking too long
9	I will send the money using a different method
11	Fees or exchange rate are not acceptable
12	I created this transaction by mistake (test or trial)
13	Other reason (please specify)

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Bodyapplication/json

Examples

Under CancellationInstant Cancel

{
    "data": {
        "remitter_reference_no": "BALADLINK-XXXXXXXXXX",
        "transaction_status_code": 22,
        "transaction_status_description": "Under Cancellation"
    },
    "errors": null
}

🟠400Cancellation Not Available

🟠400Reference No Not found

🟠400Transaction already canceled

Cancel transaction

Cancellable Transactions#

Cancellation Reasons#

Request

Request Code Samples

Responses

Cancellable Transactions

Cancellation Reasons