1. Read
Freedom Pay
  • Overview
  • Gateway API
    • Overview
    • Sync API
      • Overview
      • Card data encryption
      • Payments
        • Overview
        • Pay by card
        • Pay by card: complete 3DS
        • Pay with Apple Pay
        • Pay with Google Pay
        • Pay by recurring profile
        • Create payment page
        • Create payment page with any amount
        • Capture payment (clearing)
        • Cancel payment
        • Refund payment
        • Get payment status
      • Payout
        • Overview
        • Pay out to card
        • Pay out to IBAN
        • Get payout balance
        • Get payout status
      • Transfer
        • Overview
        • Transfer from card to card
        • Transfer from card to card: complete 3DS
        • Get exchange rates
        • Get transfer status
      • Saved cards
        • Overview
        • Save card
        • Save card: complete 3DS
        • List saved cards
        • Remove saved card
        • Pay by card token
        • Pay out to card token
        • Get payment status
    • Async API
      • Overview
      • Create
        • Create payment
      • Read
        • Get payment status
          POST
        • Get request result
          POST
      • Edit
        • Capture payment (clearing)
        • Cancel payment (reverse)
        • Refund payment
  • Merchant API
    • Overview
    • Purchase
      • Overview
      • Checkout
      • Card token
        • Overview
        • Tokenize card
        • Delete token
        • Card token list
        • Create payment (with CVC)
        • Confirm payment (with CVC)
        • Create payment
        • Confirm payment
      • Create payment
      • Any amount
      • Reccuring payment
      • Cancel payment
      • Clearing
      • Refund payment
      • Status
    • Payout
      • Overview
      • Card token
        • Tokenize card
        • Delete token
        • Card token list
        • Create payment
      • Create payment
      • IBAN
      • Balance status
      • Status
    • Mobile balance
      • Overview
      • Init
      • Pay
      • Approve
      • Resend code
      • Status
    • Invoice
      • Overview
      • Recurring profile
        • Overview
        • Create
        • Cancel
        • Info
        • Notify
      • Tips
        • Overview
        • Create
      • Create
      • Execute
      • Info
      • Refund
      • Status
      • Cancel
    • SDK
      • JS SDK
      • Merchant SDK
        • Google Pay
        • Android
        • IOS
    • CMS
      • Overview
      • Get Merchant ID and key
      • WordPress
        • Overview
        • Installation
        • Configuration
        • Test
        • Live payments
        • Update
      • Tilda
        • Overview
        • Installation
        • Configuration
        • Test
        • Live payments
      • InSales
        • Overview
        • Installation
        • Configuration
        • Test
        • Live payments
      • Ecwid
        • Overview
        • Installation
        • Configuration
        • Test
        • Live payments
      • Bitrix
        • Overview
        • Installation
        • Configuration
        • Test
        • Live payments
      • PrestaShop
        • Overview
        • Installation
        • Configuration
        • Test
        • Live payments
      • OpenCart
        • Overview
        • Installation
        • Configuration
        • Test
        • Live payments
    • Installment
      • Overview
      • Status
        • Application Status
        • Application Callback Status
        • Application Change Status
      • Get partners
      • Create application
    • Redirect back
      POST
    • Result notify
      POST
    • Payout notify
      POST
    • Check request
      POST
  • Partner API
    • Rates
      • Overview
      • Rates
    • Products
      • Overview
      • Dictionaries
      • Add client with product
      • Client request status
      • Create terminal
      • Update terminal limits
      • Product request status
    • E-Money
      • Overview
      • Add
      • Owner identification
      • Info
      • Close
      • Block
      • Balance
      • Statement
      • Request Status
    • Device ID
      • Android SDK
      • iOS SDK
    • Implement SuperApp
      • Overview
      • Pay
      • Refund
      • Status
    • Account
      • Overview
      • Create payment
      • Payment status
      • Batch statuses
      • Statement
      • Statement status
      • Balance
      • Balance status
    • Invoices
      • Info
  1. Read

Get request result

KZ
https://api.freedompay.kz
KZ
https://api.freedompay.kz
POST
https://api.freedompay.kz
/v5/g2g/read
Returns the result of a previously sent request by its X-Request-Id.
The X-Action header must be gateway.request.status.
Sign the request with X-JWS-Signature: see Async API Overview.
Use it when the response to the original request was lost or returned with X-Request-Status: process.
Results of requests are kept for a limited time: after that the API returns 404.

Request result flow#

Three identifiers are involved: X-Request-Id of this status request (any new UUID), id in the body (X-Request-Id of the checked request) and response.id (the payment).
Repeating the original request with the same X-Request-Id is also safe: the operation is not performed again and the current state is returned.

Result#

ResponseMeaningNext step
status = processThe checked request is still being processed: response holds the current state.Repeat the request later.
status = successThe checked request is processed: response holds the response of the original method.Use response as the response to the original request.
status = errorThe checked request is rejected or declined: response holds the response with error.See response.error.
{}, X-Request-Status: processThe result is not ready yet.Repeat the request in a few seconds.

Errors#

The error is returned in error.code and error.description.
HTTPerror.codeWhenWhat to do
404—No request with this id was found for the merchant: it may never have been sent, may belong to another merchant, or its result is no longer kept.Check id. If the result is no longer kept, get the payment state with gateway.payment.status by id or order_id.
4009400The body is not valid JSON.Fix the request.
4019998The signature is invalid.Check the signature: see Async API Overview.
4229403id is not a UUID or a required header is missing. The reason is in error.description.Fix the request.
5009999Internal error at the gateway entry point.Repeat the request later.
50010000Internal error in payment processing.Repeat the request later.

Request

Header Params

Body Params application/json

Example
{
  "id": "e7d2e2a2-8726-41a5-92ef-10bc8e638383"
}

Responses

🟢200OK
application/json
Headers

Bodyapplication/json

Examples
{
  "id": "e7d2e2a2-8726-41a5-92ef-10bc8e638383",
  "status": "process",
  "response": {
    "id": "01a13063-ec27-7747-963f-1e3d9c9f46fc",
    "status": "process",
    "amount": 100,
    "created_at": "2026-10-12T13:53:37.319477819Z"
  }
}
🟠422Unprocessable Entity
🟠400Bad Request
🟠401Unauthorized
🟠404Not Found
🔴500Internal Server Error
Previous
Get payment status
Next
Capture payment (clearing)