Void a reservation of funds

This operation is asynchronous. It is responded to by the voidReservationResponse operation A previous reservation should exist for this to be successful createReservation operation

Scheme	Applicable
ZA_EFT	✓
ZA_RPP	✓
ZA_RTC	✓

Request

header Parameters

traceparent	string (traceparent) ^[A-Fa-f0-9]{2}\-[A-Fa-f0-9]{32}\-[A-Fa-f0-9]... A value used to trace an HTTP message within an Electrum Regulated Payments implementation. This field must be set as per the `traceparent` element defined in the W3C Trace Context Level 2 specification.
tracestate	string (tracestate) ^[A-Za-z0-9=, _\*/@]{0,1024}$ A value used to provide context to an HTTP message as it is traced within an Electrum Regulated Payments implementation. This field must be set as per the `traceparent` element defined in the W3C Trace Context Level 2 specification.

Request Body schema: application/json

required	object (MessageIdentifiers) Holds a point-to-point unique message identification string as well as a message's creation date time.
	object A list of key-value pairs to support adding any supplementary/additional data to an Electrum Regulated Payments API message.
required	object (TransactionIdentifiers) Holds a series of identifiers to identify the transaction or an individual message that is part of a transaction.
required	object (PaymentAccount) Representation of an account for payment purposes. Note that at least one of `identification` or `proxy` is expected to be present.
required	object (Amount)
initiationSource	string Free text field used to inform the core banking system of which system is initiating the void.
paymentUetr required	string <UUID> UUID which links the void to a payment instruction, and its initial reservation.
schema required	string Value: "VoidReservationRequest"

Responses

202

Accepted. RFC9110 - 202

400

Bad request. RFC9110 - 400

401

Unauthorized. RFC9110 - 401

403

Forbidden. RFC9110 - 403

405

Method not allowed. RFC9110 - 405

422

Unprocessable content. RFC9110 - 422

429

Too Many Requests. RFC6585 - 429

500

Internal server error. RFC9110 - 500

503

Service unavailable. RFC9110 - 503

post/funds-management/reservation/void

Request samples

application/json

{"schema": "VoidReservationRequest",
"messageIdentifiers": {"messageIdentification": "msg-54321",
"creationDateTime": "2025-02-01T11:00:00Z"
},
"transactionIdentifiers": {"endToEndIdentification": "e2e-54321",
"transactionIdentification": "txn-54321",
"uetr": "123e4567-e89b-12d3-a456-426614174001"
},
"paymentUetr": "123e4567-e89b-12d3-a456-426614174000",
"accountIdentification": {"identification": {"schema": "GENERIC",
"scheme": {"schema": "PROPRIETARY",
"value": "AProprietaryCode789"
},
"issuer": "Amazing Bank",
"value": 987654123
},
"type": {"schema": "CODE",
"value": "CACC"
}
},
"amount": {"value": 50,
"currency": "ZAR"
},
"initiationSource": "EPC Singles",
"supplementaryData": {"key1": "value1",
"key2": "value2"
}
}

Response samples

application/json

{"detail": "string",
"message": "string",
"schema": "ErrorDetail"
}