Skip to main content

Voiding a Payment

Void is used after authorizing a payment if you need to cancel the authorization before capturing it. The authorization should be voided within a set timeframe usually 5-7 days maximum.

Amazon Payment Services provides merchants with flexible options to void payments according to their business needs and technical capabilities. You can choose the method that best suits your workflow and integration requirements.

Prerequisites

Before voiding a payment, ensure you have:

  1. Valid Authorization
    The payment must be in an authorized state with a valid merchant reference or Fort ID from the original authorization transaction.

  2. Security Credentials
    Retrieve your integration credentials from the merchant dashboard:

    1. Log into your Amazon Payment Services account
    2. Navigate to Merchant ManagementSecurity Settings
    3. Save the following values:
      • Access Code - Authentication token for API requests
      • Merchant Identifier - Your unique merchant ID
      • SHA Request/Response - Keys for signature calculation

Void Methods

Through the Dashboard

You can use Amazon Payment Services dashboard to void a payment by following these steps:

1

Access Transaction Management

Login to your Amazon Payment Services account and navigate to Order Transaction Management tab.

2

Search for Transaction

Search for the transaction you need to void by using its merchant reference or fort ID.

3

Void Payment

Choose Void from the Action button on the right. The amount will be filled automatically, then click on Confirm.

The system will not allow you to void an amount larger or less than the authorized amount. Partial voids are not supported.

Through the API

For more advanced options, you can use our void authorization API. Requests should be sent as POST JSON from the backend.

API Endpoints

https://sbpaymentservices.PayFort.com/FortAPI/paymentApi

Request Sample

JSON
{
"command": "VOID_AUTHORIZATION",
"access_code": "s4lwuuoY5upZlZY5D6dr",
"merchant_identifier": "WeVJHPYm",
"merchant_reference": "Test",
"language": "en",
"signature": "{{signature}}"
}

Make sure merchant reference value matches the merchant reference used in the original authorization request.

Check signature calculation section to learn how to calculate the signature.

Partial voids are not supported. Initiating a void authorization will cancel the full transaction amount. In addition, you cannot void amount that has been partially captured.

Response Sample

Response Sample
{
"response_code": "08000",
"acquirer_response_message": "Success",
"signature": "890a0cf3d1ce5c52920bba09a6ead4df9cd06676cddf08ee7d4ecda83c8d70a1",
"merchant_identifier": "WeVJHPYm",
"access_code": "s4lwuuoY5upZlZY5D6dr",
"language": "en",
"fort_id": "169996200024063280",
"command": "VOID_AUTHORIZATION",
"response_message": "Success",
"merchant_reference": "Test1",
"acquirer_response_code": "00",
"status": "08"
}

To get a detailed view of all required and optional fields, see our API reference.

Check transaction status

To check the transaction status, check the Check a Transaction Status section.

Handling the response

If you have a webhook, check the webhook section to understand how we send transaction responses to your system.

Through Batch

To bulk void payments, you need to upload a batch file for automated void authorization.
Visit Batch section to learn more.

Was this page helpful?

Thanks for your feedback!