按 E2E ID 查询 Cash Out
通过 End-to-End ID 查询 PIX 交易,该标识由 BACEN 在即时支付系统 (SPI) 中分配。
端点
GET /api/external/transactions/e2e/:e2e_id请求头
| 头 | 类型 | 必填 | 描述 |
|---|---|---|---|
Authorization | String | 是 | ApiKey {client_id}:{client_secret} |
路径参数
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
e2e_id | String | 是 | End-to-End ID(格式:E{ISPB}{YYYYMMDDHHmm}{序号}) |
E2E ID 格式
End-to-End ID 遵循 BACEN 标准:E + ISPB(8 位数字)+ 日期时间(12 位数字)+ 序号。示例:E37839059202603091530abcdef01。ISPB 37839059 标识 Owem Pay。
示例
bash
curl -X GET https://api.owem.com.br/api/external/transactions/e2e/E37839059202603091530abcdef01 \
-H "Authorization: ApiKey $CLIENT_ID:$CLIENT_SECRET"成功响应 -- 200
json
{
"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"
}
}响应结构与按 ID 查询完全相同。所有货币金额均以基本单位表示(/ 10,000 = 雷亚尔)。
错误响应 -- 404
json
{
"worked": false,
"detail": "Transacao nao encontrada para o E2E ID informado"
}