Check Transaction Status

Copy page

Copy page as Markdown for LLMs

Open in ChatGPT

Ask questions about this page

Open in Claude

Ask questions about this page

Check Status is a request you can use to find out the current status of a payment and the latest action on it. However, this API doesn't return all possible outcomes of a payment. It mainly reflects the financial completion of a transaction, meaning the payment was successfully processed and confirmed by our system and third party providers.

If the payment wasn't fully completed (e.g. the customer didn't finish 3D Secure, or there was an API or fraud error), the Check Status response alone won't be enough to update the order status in your systems.

How It Works

1

Customer Payment Processing

The customer will process online payment using one of our integration types (Hosted Checkout, Custom Integration, Mobile Integration).

2

Send Check Status Request

You will send a Check Status request from your server to Amazon Payment Services as a REST POST request in JSON format. This request includes either the merchant_reference, fort_id, or both to check the status of the payment.

3

Status Verification

Amazon Payment Services checks whether the payment linked to the sent merchant_reference or fort_id is fully completed.

4

Return Response

If the payment is complete, we will return the final payment response to your server, confirming the transaction status.

Prerequisites

Before checking transaction status, ensure you have:

1. Valid Transaction Reference
   Either the merchant_reference or fort_id from the original payment transaction you want to check.

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

The merchant_reference or fort_id used in the Check Status request must match the one from the original online payment you want to check the status for.

Integration Steps

Send Check Status Request

Use the appropriate endpoint based on your environment:

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

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

Request Sample

JSON Request

{
    "query_command": "CHECK_STATUS",
    "access_code": "s4lwuuoY5upZlZY5D6dr",
    "merchant_identifier": "WeVJHPYm",
    "merchant_reference": "Test123",
    "fort_id": "11111111111",
    "language": "en",
    "signature": "{{signature}}"
}

Refer to our Signature Calculation Guide for detailed implementation instructions and code examples.

Response Sample

JSON Response

{
    "query_command": "CHECK_STATUS",
    "access_code": "s4lwuuoY5upZlZY5D6dr",
    "merchant_identifier": "WeVJHPYm",
    "merchant_reference": "Test123",
    "fort_id": "11111111111",
    "language": "en",
    "response_code": "12000",
    "response_message": "Success",
    "status": "12",
    "transaction_code": "06000",
    "transaction_status": "06",
    "transaction_message": "Success",
    "authorized_amount": "200000",
    "captured_amount": "500",
    "refunded_amount": "100",
    "signature": "{{signature}}"
}

To check the status of refunds, use the maintenance_reference instead of merchant_reference

For detailed parameter specifications, refer to our Check Status API Reference.