Передать проверенное событие банковской ленты Plaid

POST/financial-bank-provider-webhooks/plaid

Проверяет ротацию ключей Plaid ES256, SHA-256 исходного тела, среду, время и идентичность повтора, затем сохраняет неизменяемую квитанцию и ставит инкрементальную синхронизацию в очередь.

Авторизация

plaid-verification: <PLAID_VERIFICATION>

Проверочный JWT Plaid ES256: до приёма проверяются хеш тела запроса, идентификатор ключа, среда и время выдачи.

Руководство по подключению

Параметры

plaid-verificationЗаголовок · Обязательно: Проверочный JWT Plaid ES256: до приёма проверяются хеш тела запроса, идентификатор ключа, среда и время выдачи.
string
Полное определение
{ "type": "string", "example": "example" }
Plaid-VerificationЗаголовок · Обязательно: JWT Plaid ES256, привязывающий хеш точного исходного тела запроса и время выдачи.
string
Полное определение
{ "type": "string", "example": "example" }

Тело запроса

Обязательно

Точное JSON-тело webhook Plaid, проверяемое по SHA-256 исходных байтов.

application/json

object

Полное определение

{
  "type": "object",
  "additionalProperties": {
    "$ref": "#/components/schemas/JsonValue"
  },
  "example": {
    "exampleKey": "example"
  }
}

Ответы

200Проверенный webhook принят или распознан как точный повтор.

FinancialBankWebhookResultDto

Полное определение

{
  "$ref": "#/components/schemas/FinancialBankWebhookResultDto"
}

Пример ответа · 200 · application/json

{
  "accepted": true,
  "replay": true
}

Схемы

JsonValue

Рекурсивно допустимое JSON-значение. Используется только там, где контракт явно разрешает произвольные структурированные данные.

Полное определение

{
  "oneOf": [
    {
      "type": "string",
      "nullable": true,
      "example": "example"
    },
    {
      "type": "number",
      "example": 0
    },
    {
      "type": "boolean",
      "example": true
    },
    {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/JsonValue"
      },
      "example": [
        "example"
      ]
    },
    {
      "type": "object",
      "additionalProperties": {
        "$ref": "#/components/schemas/JsonValue"
      },
      "example": {
        "exampleKey": "example"
      }
    }
  ],
  "description": "Рекурсивно допустимое JSON-значение. Используется только там, где контракт явно разрешает произвольные структурированные данные.",
  "example": "example"
}

FinancialBankWebhookResultDto

Представление результата банковского webhook, принадлежащее домену Finance PRO.

acceptedОбязательно: True после успешной проверки среды, времени, тела и повторов подписанного callback провайдера.
boolean
Полное определение
{ "type": "boolean", "description": "True после успешной проверки среды, времени, тела и повторов подписанного callback провайдера.", "example": true }
replayОбязательно: True, если callback совпадает с ранее принятой неизменяемой квитанцией и не вызывает повторную обработку.
boolean
Полное определение
{ "type": "boolean", "description": "True, если callback совпадает с ранее принятой неизменяемой квитанцией и не вызывает повторную обработку.", "example": true }

Полное определение

{
  "type": "object",
  "properties": {
    "accepted": {
      "type": "boolean",
      "description": "True после успешной проверки среды, времени, тела и повторов подписанного callback провайдера.",
      "example": true
    },
    "replay": {
      "type": "boolean",
      "description": "True, если callback совпадает с ранее принятой неизменяемой квитанцией и не вызывает повторную обработку.",
      "example": true
    }
  },
  "required": [
    "accepted",
    "replay"
  ],
  "description": "Представление результата банковского webhook, принадлежащее домену Finance PRO.",
  "example": {
    "accepted": true,
    "replay": true
  }
}