For AI agents: the complete documentation index is at /llms.txt, and the full text of every page is at /llms-full.txt. Most pages are also available as Markdown by adding .md to the URL.

Canceling a transaction using the POS

To cancel a transaction using the POS, send a PUT request to the relevant endpoint.

Scenario	Merchant uses the POS to:
The terminal prompts a customer to use a card to pay for the transaction. However, the customer wants to use cash to pay for the transaction.	Cancel the transaction on the terminal.

Important things to consider

The PUT request doesn’t contain a message body.
If a cancel request is successful, the gateway returns two responses:
- A response for the cancel request
- A response for the transaction that the POS canceled

Note: Don’t program the POS to receive these responses in a particular order because the gateway may send either response before the other.

Endpoints

Environment	URL
Test	https://api.pit.paygateway.com/terminal/request/reference\_id/{reference_id}/cancel
Production	https://api.paygateway.com/terminal/request/reference\_id/{reference_id}/cancel

Response fields

Response to a cancel request

The response to a cancel request doesn’t contain a message body. The HTTP status code indicates if the request was successful.

Note: If the POS receives an HTTP status code of 403, the POS can’t cancel the transaction. This can be because of one of the following reasons:

The transaction doesn’t exist.
The terminal sent the transaction to us for processing. The merchant needs to void the transaction.

Response fields for a transaction request

Field	Type	Description
amount	String	Total dollar amount of the transaction. If the cancel request was successful, we return a value of 0.00.
status	String	Indicates the status of the transaction. If the cancel request was successful, we return a value of `pos_cancelled`. For a list of possible values, see the transaction status enumeration.
currency_code	String	ISO currency code for the transaction. For a list of possible values, see the currency code enumeration.

Canceling a transaction using the POS | Global Payments