Consulter Cash Out par ID

Consulte les details et le statut d'une transaction PIX par le transaction_id.

Endpoint

GET /api/external/transactions/:id

En-tetes

En-tete	Type	Obligatoire	Description
Authorization	String	Oui	ApiKey {client_id}:{client_secret}

Path Parameters

Parametre	Type	Obligatoire	Description
id	String	Oui	ID de la transaction (transaction_id)

Exemple

curl -X GET https://api.owem.com.br/api/external/transactions/PIXOUT20260309a1b2c3d4e5f6 \
  -H "Authorization: ApiKey $CLIENT_ID:$CLIENT_SECRET"

Reponse de Succes -- 200

{
  "worked": true,
  "data": {
    "id": "c7f3a8b1-2d4e-4f6a-9c1b-3e5f7a9b1d3e",
    "transaction_id": "PIXOUT20260309a1b2c3d4e5f6",
    "end_to_end_id": "E37839059202603091530abcdef01",
    "external_id": "order-9876",
    "type": "pix",
    "direction": "outbound",
    "status": "completed",
    "amount": 300000,
    "fee_amount": 350,
    "net_amount": 300350,
    "description": "Pagamento fornecedor",
    "counterparty_name": "Joao Silva",
    "recipient_key": "12345678901",
    "created_at": "2026-03-09T15:30:00Z",
    "completed_at": "2026-03-09T15:30:02Z"
  }
}

Champs de la Reponse

Champ	Type	Description
data.id	String	UUID interne de la transaction
data.transaction_id	String	Identifiant unique de la transaction
data.end_to_end_id	String	Identifiant End-to-End dans le SPI/BACEN
data.external_id	String	Identifiant de votre systeme. null si non renseigne
data.type	String	Type de la transaction (pix)
data.direction	String	outbound (cash-out) ou inbound (cash-in)
data.status	String	Statut actuel (voir tableau ci-dessous)
data.amount	Integer	Montant en unites de base (/ 10 000 pour reais). 300000 = R$ 30,00
data.fee_amount	Integer	Frais factures en unites de base
data.net_amount	Integer	Montant net en unites de base
data.description	String	Description renseignee lors de la creation
data.counterparty_name	String	Nom de la contrepartie (payeur ou beneficiaire)
data.recipient_key	String	Cle PIX du destinataire (uniquement pour les envois)
data.created_at	String	Date de creation (ISO 8601)
data.completed_at	String	Date de conclusion (ISO 8601), null si en attente

Statut de la Transaction

Statut	Description
pending_approval	En attente d'approbation (flux creer + approuver)
processing	Envoyee au SPI, en attente de liquidation
completed	Liquidee avec succes
failed	Rejetee par le SPI ou erreur de traitement
refunded	Remboursee (totalement ou partiellement)

Reponse d'Erreur -- 404

{
  "worked": false,
  "detail": "Transacao nao encontrada"
}