重新发送交易 webhook
将特定交易的 webhook 重新发送到已配置的 URL 或临时 URL(覆盖)。
交易标识符可以是:
- 数字交易 ID:Avista 返回的 ID(webhooks 中的
transactionId 字段)
- 您的引用 ID:创建交易时提供的标识符(
externalId)
- PIX End-to-End ID:webhooks 中返回的
e2eId(格式:E/D + 32 个字符)
需要在 Authorization 头中提供 Bearer 令牌。
| 参数 | 类型 | 必填 | 描述 |
|---|
transactionIdentifier | string | 是 | 交易标识符:数字 id、externalId 或 endToEndId |
| 字段 | 类型 | 必填 | 描述 |
|---|
url | string | 否 | 此次重新发送的临时 URL。如果未提供,将使用账户 webhook 中配置的 URL。该 URL 不会被持久化 |
{
"url": "https://meu-servidor.com/webhooks/avista"
}
- 如果请求体中提供了
url,则临时使用该 URL(不会持久化)
- 如果未提供
url,则使用账户 webhook 中为该操作类型配置的 URL
- 如果没有可用的 URL,返回错误 400
| 字段 | 类型 | 描述 |
|---|
message | string | 结果描述信息 |
webhookLogId | number | 为审计生成的 webhook 日志 ID |
sentAt | string | Webhook 发送日期/时间(ISO 8601) |
statusCode | number | 目标 URL 返回的 HTTP 状态码 |
{
"message": "Webhook resent successfully",
"webhookLogId": 12345,
"sentAt": "2024-01-15T10:30:00.000Z",
"statusCode": 200
}
| 状态码 | 描述 |
|---|
| 400 | 没有可用的 webhook URL。请为此交易的操作类型配置 webhook,或在 url 字段中提供临时 URL |
| 401 | 令牌无效、已过期或缺失 |
| 404 | 交易未找到或不属于已认证的账户 |
| 429 | 超过速率限制(最大 60 请求/分钟) |