Withdraw a maker-checker action

DELETE

/maker-checker-actions/{id}

Cancels a pending maker-checker action before any approver has finished deciding on it, taking it out of the approval queue entirely. Only the identity that originally requested the action (the requester_identity_id on the record) may withdraw it, and only while it is still pending — once an action has moved to approved, rejected, or has already been withdrawn, this endpoint will reject the request.

The id path parameter identifies the maker-checker action itself (not the resource it guards, e.g. not the payout id). The action's entity_id and the calling identity are both derived from the authenticated bearer token, so a request can only withdraw actions that belong to the caller's own entity.

Withdrawal is a terminal state: once withdrawn, a new maker-checker action must be created from scratch to retry the guarded operation.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Body Params application/json

Examples

Responses

🟢200

application/json

The maker-checker action was pending and has been withdrawn successfully.

Bodyapplication/json

🟠400

🟠401

🟠403

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE '/maker-checker-actions/01JMCA1234567890ABCDEFGHIJ' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "status_reason": "Submitted with the wrong counterparty, re-creating with corrected details"
}'

Response Example

200 - Success

{
    "message": "Maker-checker action withdrawn successfully",
    "status": "success",
    "data": {
        "id": "01JMCA1234567890ABCDEFGHIJ",
        "entity_id": "01JENTITY1234567890ABCDEF",
        "reference_id": "01JPAYOUT1234567890ABCDEF",
        "type": "payout",
        "maker_checker_group_id": "01JMCG1234567890ABCDEFGHI",
        "requester_identity_id": "01JIDENT1234567890ABCDEFG",
        "requester": {
            "id": "01JIDENT1234567890ABCDEFG",
            "name": "Jane Doe",
            "email": "jane.doe@example.com"
        },
        "approvers": [
            {
                "approval_order": 1,
                "identity_id": "01JIDENT234567890ABCDEFGH",
                "identity": {
                    "id": "01JIDENT234567890ABCDEFGH",
                    "name": "John Smith",
                    "email": "john.smith@example.com"
                }
            }
        ],
        "approvals": [],
        "status": "withdrawn",
        "status_reason": "Submitted with the wrong counterparty, re-creating with corrected details",
        "amount": 15000,
        "currency": "NGN",
        "counterparty": null,
        "is_requester": true,
        "created": 1736899200000,
        "updated": 1736899320000
    }
}

Modified at 2026-09-30 00:29:45

List maker-checker actions

Create a payment page