Skip to main content
GET
Use GET /payment/inquiry/{id} to retrieve the current status and details of any payment. Pass either the paymentCode that Therius returned when the payment was created (e.g. PC-1234567890) or the internal payment UUID. This endpoint is useful for polling pending payments, reconciliation, and debugging.
Unlike the payment/subscription responses elsewhere in this API, amount here is a flat integer in the currency’s minor units with a separate top-level currency field — not a { currency, value, exponent } object.

​
Look up a declined payment

​
Query sandbox without an API key

If no payment exists for the provided id, the API returns 404 Not Found. Verify the paymentCode or UUID and ensure you’re querying the correct environment (production vs. sandbox).
You can use this endpoint to poll for the final status of pending_3ds or pending_action payments if you prefer not to use webhooks. However, webhooks are recommended for production — they push the final status to your server as soon as it’s available, without requiring polling.

Authorizations

​
Authorization
string
header
required

Your secret API key: Bearer prv_production_xxx (production) or Bearer prv_sandbox_xxx (sandbox).

Headers

​
X-Environment
enum<string>

Set to sandbox to look up a sandbox payment without an API key (e.g. client-side status polling). Defaults to production.

Available options:
sandbox,
production

Path Parameters

​
id
string
required

The paymentCode (e.g. PC-1234567890) or the internal payment UUID.

Response

200 - application/json

Payment details

Current state of a payment. Note amount here is a flat integer in minor units with a separate currency, unlike the Amount object used elsewhere.

​
id
string

Internal Therius payment UUID.

​
merchantId
integer

Your merchant account ID.

​
orderCode
string

Your original order reference.

​
paymentCode
string

Therius receipt ID.

​
status
enum<string>

captured - funds settled; authorized - funds reserved, call capture to settle; declined - issuer declined, see refusalCode; pending_3ds - a 3DS challenge is required, see actionRequired; pending_action - an external action (redirect, voucher) is required, see actionRequired; failed - processing error unrelated to the issuer; cancelled - authorization voided; refunded - captured funds returned.

Available options:
captured,
authorized,
declined,
pending_3ds,
pending_action,
failed,
cancelled,
refunded
​
amount
integer

Payment amount in the currency minor units.

​
currency
string

ISO 4217 currency code.

​
authorizationCode
string

Issuer authorization code. Present on authorized and captured payments.

​
refusalCode
object

Present when status is declined. See the Declined Payments concept page for the full code table and how to react to each recoveryAction.