v1

latestOpenAPI 3.0.02026-07-263118119.8 KB
Create & Manage Transactions

getTransactionByIdempotencyKey

Fetches the original transaction response by the idempotency key used during the POST /v2/transaction request.

Security Behavior

To prevent information leakage, this endpoint returns an empty object {} in all negative cases — including when the idempotency key does not exist and when the key exists but belongs to a different merchant. Callers cannot distinguish between the two scenarios.

Loss of Reference Behavior

The idempotency key can reference the transaction only until the TTL expires. The current TTL is 1 day. After that, the transaction may exist but cannot be retrieved by the idempotency key.

get/v2/transaction/idempotency/{idempotencyKey}

Headers

Content-Typestring
authorizationstring

A merchant scoped token.

Response

Returns the transaction response originally stored for this idempotency key, or an empty object if no record is found or the key belongs to a different merchant.

OR
EmptyResponse required

Example response

{}