Skip to main content
GET
Use GET /payment/inquiry/{id} para recuperar o status atual e os detalhes de qualquer pagamento. Passe o paymentCode que o Therius devolveu quando o pagamento foi criado (p. ex. PC-1234567890) ou o UUID de pagamento interno. Este endpoint é útil para fazer polling de pagamentos pendentes, conciliação e depuração.
Diferente das respostas de pagamento/assinatura no resto desta API, amount aqui é um inteiro simples nas unidades menores da moeda, com um campo currency separado no nível superior — não um objeto { currency, value, exponent }.

​
Buscar um pagamento recusado

​
Consultar o sandbox sem uma chave de API

Se não existir nenhum pagamento para o id fornecido, a API devolve 404 Not Found. Verifique o paymentCode ou o UUID e certifique-se de que você está consultando o ambiente correto (produção vs. sandbox).
Você pode usar este endpoint para fazer polling do status final de pagamentos pending_3ds ou pending_action se você preferir não usar webhooks. No entanto, os webhooks são recomendados para produção — eles empurram o status final para o seu servidor assim que ele está disponível, sem exigir polling.

Autorizações

​
Authorization
string
header
obrigatório

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

Cabeçalhos

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

Opções disponíveis:
sandbox,
production

Parâmetros de caminho

​
id
string
obrigatório

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

Resposta

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.

Opções disponíveis:
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.