Refunding a Payment

Copy page

Copy page as Markdown for LLMs

Open in ChatGPT

Ask questions about this page

Open in Claude

Ask questions about this page

Refund is used after capturing a payment if you need to return funds to the customer. A refund can be issued fully or partially based on the original captured transaction amount.

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

Prerequisites

Before refunding a payment, ensure you have:

1. Valid Captured Transaction
   The payment must be in a captured state with a valid merchant reference or Fort ID from the original captured transaction.

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

   1. Log into your Amazon Payment Services account
   2. Navigate to Merchant Management → Security 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

Refund Methods

Dashboard

Process refunds manually using the merchant dashboard - ideal for individual transaction refund management

API

Integrate refund processing programmatically into your system using our APIs for automated workflows

Batch

Process multiple refunds at once by uploading a batch file - perfect for bulk refund operations

Through the Dashboard

You can use Amazon Payment Services dashboard to refund 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 refund by using its merchant reference or fort ID.

3

Refund Payment

Choose Refund from the Action button on the right. Enter the amount to refund (either partial or full), then click on Confirm.

The system will not allow you to refund an amount larger than the captured amount.

Through the API

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

API Endpoints

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

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

Request Sample

JSON

{
    "command": "REFUND",
    "access_code": "s4lwuuoY5upZlZY5D6dr",
    "merchant_identifier": "WeVJHPYm",
    "merchant_reference": "Test",
    "amount": "300",
    "currency": "AED",
    "language": "en",
    "signature": "{{signature}}"
}

Make sure merchant reference value matches the merchant reference used in the original transaction.

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

Refunding an amount larger than the captured amount will return an 'Operation amount exceeds captured amount' error.

Response Sample

Response Sample

{
    "response_code": "06000",
    "amount": "100",
    "signature": "d9c7e2dd9fabd8c224612172be506415b8b1e5067a6c307b237b2d9bce18bc26",
    "merchant_identifier": "WeVJHPYm",
    "access_code": "s4lwuuoY5upZlZY5D6dr",
    "language": "en",
    "fort_id": "169996200024059857",
    "command": "REFUND",
    "response_message": "Success",
    "merchant_reference": "Test",
    "currency": "AED",
    "acquirer_response_code": "00",
    "status": "06"
}

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 refund payments, you need to upload a batch file for automated refund processing.
Visit Batch section to learn more.