Skip to main content
GET
cURL
Fetch the current transaction record by its order_id and transaction_id. Both are returned by Sale and Pre-authorization. The request returns 403 if order_id doesn’t belong to the transaction. See Transaction status for the full set of status.status values, the status object shape, and how to interpret reasonCode and domain. See Status reason codes for the complete reason-code catalog.

Additional response context

Beyond status, the response can include:
  • retry — present while a failed transaction has an automatic retry scheduled. Its plan_id is the identifier you pass to Complete payer actions.
  • pending_payer_actions — present when the payer must take an action (such as entering a security code or confirming a currency change) before the transaction can proceed. It is always present together with retry.
  • payer_action_url — present whenever pending_payer_actions is present. It opens the hosted page where the payer completes the pending actions. See Complete payer actions for which actions you can complete yourself.
  • hosted_page_url — present only while a payment_collection: hosted_page transaction is still waiting for the payer to supply a credential. Redirect the payer to this URL instead of building it yourself.
  • risk_decision — present when a risk policy evaluated this transaction. allowed says whether it passed, and blockedBy lists each blocking policy with its type (blocklist, velocity, or risk_rules), policyId, policyName, and details. A blocked transaction carries the status reason RISK/BLOCKED.

Authorizations

x-signature
string
header
required

Lowercase hex HMAC-SHA256 of {x-timestamp}.{METHOD}.{path_with_query}.{raw_body} keyed with your API secret. See https://www.smartretry.com/docs/authentication.

x-timestamp
string
header
required

Current Unix time in seconds; must be within 5 minutes of server time and match the value used in the signature.

Path Parameters

order_id
string
required

The unique identifier of the order the transaction belongs to.

Required string length: 8
Pattern: ^[\dA-Za-z]{8}$
transaction_id
string
required

The unique identifier of the transaction.

Required string length: 8
Pattern: ^[\dA-Za-z]{8}$
terminal_friendly_id
string
required

The unique identifier of the terminal.

Required string length: 6
Pattern: ^[\dA-Za-z]{6}$

Response

Default Response

transaction_id
string
required
Required string length: 8
Pattern: ^[\dA-Za-z]{8}$
type
enum<string>
required
Available options:
sale,
preauth,
account_verification,
recurring_init,
recurring,
payout,
capture,
refund,
void
status
object
required
order
object
required
created_at
string
required
updated_at
string
required
authorization_code
string
arn
string
amount
number
currency
string
attempt_number
number
risk_decision
object
retry
object
pending_payer_actions
object[]
hosted_page_url
string

Payment page link for the payer. Present only while the payer has not yet supplied a credential on a hosted_page transaction.

payer_action_url
string

Page where the payer completes the pending payer actions.