Update transaction

The Update Receiver Info API allows partners to request corrections to receiver information (name and contact number) for an existing transaction.

Important Notes

Updates can only be requested for Cash Transactions and statuses that is not Final Status. Check it at Transaction Lifecycle

A support ticket is automatically created for operations team to review and approve the update

Request Processing Logic

Transaction Status	Auto Update	Ticket Created	request_status	request_status_code
Pending	Yes	No	Updated	1
Balad Compliance Suspended	Yes	No	Updated	1
Sent to BDC (Not Final)	No	Yes	In Progress	2

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Example

{
    "remitterReferenceNo": "TXN-20260115-ABC123",
    "receiverFirstName": "Ahmed",
    "receiverMiddleName": "Mohamed",
    "receiverLastName": "Ali",
    "receiverContactNo": "+201234567890"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Bodyapplication/json

Examples

Instant UpdateManual Approval Update

{
    "data": {
        "request_status": "Updated",
        "request_status_code": 1,
        "bank_reference_no": null,
        "remitter_reference_no": "XXXXXXXXXXXXXXXXXXX",
        "delivery_estimate": null
    },
    "errors": null
}

🟠400Cannot update Final Status

🟠400Invalid Transaction Type Update