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

POST/financial-bank-provider-webhooks/salt-edge

Проверяет подпись callback v6, точный URL и исходное тело, версию, время, идентификатор подключения и доказательства повтора. Затем активирует подключение либо отмечает его ухудшенное состояние и ставит инкрементальную синхронизацию в очередь.

Примеры запросов

Демонстрационные данные. Примеры не отправляют запросы. В своей интеграции подставьте значения, полученные на предыдущих шагах.

cURL

curl --request POST 'https://api.hallify.co/financial-bank-provider-webhooks/salt-edge' \
  -H 'Content-Type: application/json' \
  -H "signature: ${SIGNATURE}" \
  -H "signature-key-version: ${SIGNATURE_KEY_VERSION}" \
  --data-raw '{
  "exampleKey": "example"
}'

Пример ответа

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

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

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

Авторизация

signature: <SIGNATURE>

Подпись callback Salt Edge RSA SHA-256 над точным URL callback и исходным телом запроса.

signature-key-version: <SIGNATURE_KEY_VERSION>

Сертифицированная версия публичного ключа callback Salt Edge для строгой проверки подписи и контроля ротации.

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

Параметры

signatureЗаголовок · Обязательно: Подпись callback Salt Edge RSA SHA-256 над точным URL callback и исходным телом запроса.
string
Полное определение
{ "type": "string", "example": "example" }
signature-key-versionЗаголовок · Обязательно: Сертифицированная версия публичного ключа callback Salt Edge для строгой проверки подписи и контроля ротации.
string
Полное определение
{ "type": "string", "example": "example" }
Signature-Key-VersionЗаголовок · Обязательно: Версия публичного ключа callback Salt Edge; Finance принимает сертифицированный ключ v6.
string
Полное определение
{ "type": "string", "example": "example" }
SignatureЗаголовок · Обязательно: Подпись callback Salt Edge AIS RSA SHA-256 над URL callback и исходным телом.
string
Полное определение
{ "type": "string", "example": "example" }

Тело запроса

Обязательно

Точное JSON-тело callback Salt Edge v6, проверяемое RSA-подписью.

application/json

object

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

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

Ответы

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

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
  }
}