Pular para o conteúdo principal
GET
/
api
/
spei
/
transaction
/
{externalId}
Consultar transação SPEI por externalId / conciliationId
curl --request GET \
  --url https://sandbox.ntxpay.com/api/spei/transaction/{externalId} \
  --header 'Authorization: Bearer <token>'
{
  "id": 12345,
  "externalId": "order-abc-123",
  "conciliationId": "order_abc_123",
  "paymentMethod": "SPEI",
  "type": "cash_in",
  "provider": "smartfastpay",
  "amountCentavos": 50000,
  "clabe": "012180001234567890",
  "createdAt": "2026-05-12T14:30:00.000Z",
  "confirmedAt": "2026-05-12T14:31:05.000Z"
}

Autorizações

​
Authorization
string
header
obrigatório

JWT obtido em POST /api/auth/token

Parâmetros de caminho

​
externalId
string
obrigatório

External ID enviado no cash-in/cash-out (também aceito como conciliationId)

Resposta

Transação encontrada

​
id
integer
Exemplo:

12345

​
externalId
string | null
Exemplo:

"order-abc-123"

​
conciliationId
string | null

Alias Voluti — espelha externalId.

Exemplo:

"order_abc_123"

​
paymentMethod
string
Exemplo:

"SPEI"

​
direction
enum<string>
Opções disponíveis:
in,
out
​
type
string

cash_in, cash_out, refund_in, refund_out, internal_transfer

Exemplo:

"cash_in"

​
status
enum<string>
Opções disponíveis:
PENDING,
CONFIRMED,
FAILED,
EXPIRED
​
provider
string
Exemplo:

"smartfastpay"

​
amountCentavos
integer
Exemplo:

50000

​
clabe
string | null
Exemplo:

"012180001234567890"

​
createdAt
string<date-time>
Exemplo:

"2026-05-12T14:30:00.000Z"

​
confirmedAt
string<date-time> | null
Exemplo:

"2026-05-12T14:31:05.000Z"