Consultar status do envio PIX

curl -X GET 'https://api.goatpay.com.br/v1/transfer-pix/status/clx_transacao' \
  -H 'X-API-Key: gp_live_SUA_CHAVE'

{
  "success": true,
  "message": "Status da transferência PIX consultado",
  "data": {
    "id": "clx_transacao",
    "status": "PROCESSING",
    "amount": 50,
    "netAmount": 52,
    "feeAmount": 2,
    "externalReference": "saque-1",
    "endToEndId": null,
    "pixKey": "11999999999",
    "pixKeyType": "TELEFONE",
    "completedAt": null,
    "createdAt": "2026-06-01T14:00:00.000Z"
  },
  "requestId": "req_abc123"
}

{
  "success": true,
  "message": "Status da transferência PIX consultado",
  "data": {
    "id": "clx_transacao",
    "status": "COMPLETED",
    "amount": 50,
    "netAmount": 52,
    "feeAmount": 2,
    "externalReference": "saque-1",
    "endToEndId": "E12345678202505301234567890123456",
    "pixKey": "11999999999",
    "pixKeyType": "TELEFONE",
    "completedAt": "2026-06-01T14:05:00.000Z",
    "createdAt": "2026-06-01T14:00:00.000Z"
  },
  "requestId": "req_abc123"
}

GET

transfer-pix

status

{id}

curl -X GET 'https://api.goatpay.com.br/v1/transfer-pix/status/clx_transacao' \
  -H 'X-API-Key: gp_live_SUA_CHAVE'

{
  "success": true,
  "message": "Status da transferência PIX consultado",
  "data": {
    "id": "clx_transacao",
    "status": "PROCESSING",
    "amount": 50,
    "netAmount": 52,
    "feeAmount": 2,
    "externalReference": "saque-1",
    "endToEndId": null,
    "pixKey": "11999999999",
    "pixKeyType": "TELEFONE",
    "completedAt": null,
    "createdAt": "2026-06-01T14:00:00.000Z"
  },
  "requestId": "req_abc123"
}

{
  "success": true,
  "message": "Status da transferência PIX consultado",
  "data": {
    "id": "clx_transacao",
    "status": "COMPLETED",
    "amount": 50,
    "netAmount": 52,
    "feeAmount": 2,
    "externalReference": "saque-1",
    "endToEndId": "E12345678202505301234567890123456",
    "pixKey": "11999999999",
    "pixKeyType": "TELEFONE",
    "completedAt": "2026-06-01T14:05:00.000Z",
    "createdAt": "2026-06-01T14:00:00.000Z"
  },
  "requestId": "req_abc123"
}

curl -X GET 'https://api.goatpay.com.br/v1/transfer-pix/status/clx_transacao' \
  -H 'X-API-Key: gp_live_SUA_CHAVE'

{
  "success": true,
  "message": "Status da transferência PIX consultado",
  "data": {
    "id": "clx_transacao",
    "status": "PROCESSING",
    "amount": 50,
    "netAmount": 52,
    "feeAmount": 2,
    "externalReference": "saque-1",
    "endToEndId": null,
    "pixKey": "11999999999",
    "pixKeyType": "TELEFONE",
    "completedAt": null,
    "createdAt": "2026-06-01T14:00:00.000Z"
  },
  "requestId": "req_abc123"
}

{
  "success": true,
  "message": "Status da transferência PIX consultado",
  "data": {
    "id": "clx_transacao",
    "status": "COMPLETED",
    "amount": 50,
    "netAmount": 52,
    "feeAmount": 2,
    "externalReference": "saque-1",
    "endToEndId": "E12345678202505301234567890123456",
    "pixKey": "11999999999",
    "pixKeyType": "TELEFONE",
    "completedAt": "2026-06-01T14:05:00.000Z",
    "createdAt": "2026-06-01T14:00:00.000Z"
  },
  "requestId": "req_abc123"
}

Envelope da resposta

Campo	Tipo	Descrição
success	boolean	`true` em sucesso HTTP 2xx
message	string	Mensagem legível
data	object	Status e campos essenciais (formato abaixo)
requestId	string	ID da requisição para suporte (`req_...`)

Status em `data.status`

Status	Significado
PENDING	Em fila / aguardando SPI
PROCESSING	Processando
COMPLETED	Enviado com sucesso
FAILED	Falhou
CANCELED	Cancelado

Campos em `data`

Campo	Descrição
id	ID da transação
status	Ver tabela acima
amount	Valor conforme `coverFee` na criação
netAmount	Valor líquido debitado ou enviado
feeAmount	Tarifa da operação
externalReference	Referência enviada na criação
endToEndId	Identificador E2E após liquidação
pixKey	Chave ou BR Code de destino
pixKeyType	Tipo da chave PIX
completedAt	Data de conclusão
createdAt	Data de criação

Para favorecido (recipient) e demais detalhes, use Consultar transferência. Em produção, prefira webhooks (transfer.completed). /payouts/status/{id} é alias desta rota.

Parâmetros de rota

string

required

ID da transação ou externalReference.

Authorizations

X-API-Key

string

header

required

Chave gp_live_... criada em Integrações → Chaves de API no dashboard.

Path Parameters

string

required

ID do recurso (transação, cobrança, webhook, etc.)

Response

Status da transferência PIX (payload enxuto para polling).

success

boolean

required

Example:

true

message

string

required

data

object

required

Show child attributes

requestId

string

Introdução

Webhooks

WebSocket

PIX

Conta

Loja

Subcontas

Consultar status do envio PIX

Envelope da resposta

Status em `data.status`

Campos em `data`

Parâmetros de rota

Authorizations

Path Parameters

Response

​Envelope da resposta

​Status em data.status

​Campos em data

​Parâmetros de rota

Authorizations

Path Parameters

Response

Envelope da resposta

Status em `data.status`

Campos em `data`

Parâmetros de rota