Status API

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Transaction Fetch Behavior

The 24-hour fetch window mentioned in the documentation applies to the normal transaction flow (Scenario 1), where the POS sends the transaction response back through Client.
In this scenario, the client can fetch the transaction within the supported time window (up to 24 hours).

Fallback Fetch Flow (Scenario 2)

A second scenario was introduced as a fallback mechanism, supported starting from POS version 3.0.42.
This flow is used only when the POS does not send the transaction response through client for a successful transaction.

In this case:

In Scenario 2, the transaction must be fetched before the batch is settled on the processor side.
This fallback flow works only while the batch is still open. Once the batch is closed/settled, the processor will no longer allow the transaction to be fetched, even if the request is within the 24-hour window.

So in this scenario, the client should make sure to send the fetch request as soon as possible after the transaction, and before batch settlement.

Important Notes

  • Scenario 2 is triggered only when the POS response is missing.
  • The 24-hour fetch rule does not always apply in the fallback scenario.
  • The ability to fetch the transaction depends on switch behavior and batch status.
  • This behavior is supported only in POS version 3.0.42 and later.

Body Params
string
required
Defaults to h6tSvf0Cz7fSB86B44bkLEplS15AsWYo

Merchant APP ID (Alphanumeric - Length of 32 chars)

string
required
Defaults to zOKj0LUOiW4L9jFRrMbMiJQ5KxQEpSMm

Merchant APP Key (Alphanumeric - Length of 32 chars)

string
required
Defaults to 2412333540

EPI is an end point identifier, Identify the device on valor infrastructure, it's a 10 digit number starts with 2

string
required
Defaults to vc_status

Transaction type should be set as 'vc_status'

string
required
Defaults to INV001

Request transaction ID for each transaction unique identifier (Max character 25)

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json