# Manage Orders
source: https://developer.mastercard.com/mastercard-gateway/documentation/use-cases/manage-orders/index.md

## Update an authorization amount before capture {#update-an-authorization-amount-before-capture}

Merchants often need to adjust orders before capture due to changes such as customer cancellations, stock unavailability, quantity adjustments, pricing changes, or operational corrections.

This use case shows how to safely update an existing authorization before capture. The merchant submits an authorization adjustment request, the Mastercard Gateway processes the update with the acquirer, and the updated authorization amount is returned to the merchant.

### Prerequisites {#prerequisites}

* An existing authorization is present.
* The authorization is eligible for modification.
* The transaction has not been fully captured or voided.
* The merchant supports authorization adjustment functionality.

### Sequence diagram {#sequence-diagram}

Diagram update-auth-amount-before-capture

### Workflow {#workflow}

1. Customer Service requests an adjustment to the order amount.
2. The merchant server submits an authorization update request to the Mastercard Gateway with the revised order amount.
3. The Mastercard Gateway forwards the authorization update request to the acquirer.
4. The acquirer returns the authorization update result to the Mastercard Gateway.
5. The Mastercard Gateway returns the updated authorization result to the merchant server.
6. The merchant server confirms the updated order details to Customer Service.

### Endpoint {#endpoint}

|     API     | Format | HTTP Method |                                                                                        Operation                                                                                         |
|-------------|--------|-------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Transaction | NVP    | POST        | [Update Authorization](https://mtf.gateway.mastercard.com/api/documentation/apiDocumentation/nvp/version/100/operation/Transaction:%20%20Update%20Authorization.html?locale=en_US)       |
|             | REST   | PUT         | [Update Authorization](https://mtf.gateway.mastercard.com/api/documentation/apiDocumentation/rest-json/version/100/operation/Transaction:%20%20Update%20Authorization.html?locale=en_US) |

### Error resolution {#error-resolution}

For details on error resolution, explore our [Code and Formats](https://developer.mastercard.com/mastercard-gateway/documentation/code-and-formats/index.md) section.

## Void an authorization (cancel order before capture) {#void-an-authorization-cancel-order-before-capture}

Merchants often need to cancel orders before capture due to customer cancellations, stock unavailability, pricing adjustments, quantity changes, or operational issues.

This use case shows how to cancel an existing authorization before funds are captured. The merchant submits a void request, the Mastercard Gateway reverses the authorization through the acquirer, and the authorization is released.

### Prerequisites {#prerequisites-1}

* An existing authorization is present.
* The transaction has not been fully captured or settled.
* The merchant has permission to perform void or reversal operations.
* The original transaction reference is available.

### Sequence diagram {#sequence-diagram-1}

Diagram void-on-auth

### Workflow {#workflow-1}

1. Customer Service requests cancellation of the order.
2. The merchant server submits a VOID request to the Mastercard Gateway.
3. The Mastercard Gateway sends a request to the acquirer to reverse the existing authorization.
4. The acquirer returns the void result to the Mastercard Gateway.
5. The Mastercard Gateway returns the void confirmation to the merchant server.
6. The merchant server confirms the order cancellation to Customer Service.

### Endpoint {#endpoint-1}

|     API     | Format | HTTP Method |                                                                       Operation                                                                        |
|-------------|--------|-------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|
| Transaction | NVP    | POST        | [Void](https://mtf.gateway.mastercard.com/api/documentation/apiDocumentation/nvp/version/100/operation/Transaction%3a%20%20Void.html?locale=en_US)     |
|             | REST   | PUT         | [Void](https://mtf.gateway.mastercard.com/api/documentation/apiDocumentation/rest-json/version/100/operation/Transaction:%20%20Void.html?locale=en_US) |

### Error resolution {#error-resolution-1}

For details on error resolution, explore our [Code and Formats](https://developer.mastercard.com/mastercard-gateway/documentation/code-and-formats/index.md) section.
