Skip to main content
GET
Usa GET /payment/inquiry/{id} para recuperar el estado actual y los detalles de cualquier pago. Pasa el paymentCode que Therius devolvió cuando se creó el pago (p. ej. PC-1234567890) o el UUID de pago interno. Este endpoint es útil para sondear pagos pendientes, conciliación y depuración.
A diferencia de las respuestas de pago/suscripción del resto de esta API, amount aquí es un entero plano en las unidades menores de la moneda, con un campo currency separado en el nivel superior — no un objeto { currency, value, exponent }.

​
Buscar un pago rechazado

​
Consultar el sandbox sin una clave de API

Si no existe ningún pago para el id proporcionado, la API devuelve 404 Not Found. Verifica el paymentCode o el UUID y asegúrate de estar consultando el entorno correcto (producción vs. sandbox).
Puedes usar este endpoint para sondear el estado final de pagos pending_3ds o pending_action si prefieres no usar webhooks. Sin embargo, los webhooks se recomiendan para producción — empujan el estado final a tu servidor tan pronto como está disponible, sin requerir sondeo.

Autorizaciones

​
Authorization
string
header
requerido

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

Encabezados

​
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.

Opciones disponibles:
sandbox,
production

Parámetros de ruta

​
id
string
requerido

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

Respuesta

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.

Opciones disponibles:
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.