Integration Guide for Banks
[UKR] Посібник з інтеграції для банку
[UKR] Посібник з інтеграції для банку
  • General
    • 💰Загальний опис
      • Перекази між цифровізованими сутностями
        • Варіант 1. Швидке створення/видалення ідентифікаторів
        • Варіант 2. Стандартне створення/видалення ідентифікаторів (опціонально)
      • Історія версій
      • Журнал змін API
      • Глосарій
    • 🌐Загальні вимоги
    • 👉Базовий варіант впровадження
    • 📅План інтеграції
      • План інтеграції (Бізнес)
      • План інтеграції (Технічна команда)
      • Мультипідпис
    • ❗Повідомлення про помилки
  • 🛠️API МЕТОДИ
    • Автентифікація
      • Авторизація через JWT
      • Служба Аутентифікації Банку
      • JWT формат
    • Працівники
      • Призначити роль працівнику
      • Управління ролями
    • Клієнти
      • Сегмент
    • Цифровізовані сутності
    • Ідентифікатори
    • Трансфер (перерозподілення ідентифікаторів)
      • Мультипідпис для трансферів
      • Зворотні виклики
      • Категорія
    • Ліміти
    • Реконсиляція
    • [необов’язково] Відділення
      • Відділення (доступ)
      • Як додати працівника до віддлення (філії)
      • Фільтр по відділенню
      • Трансфери (Відділення)
Powered by GitBook
On this page
  1. API МЕТОДИ
  2. [необов’язково] Відділення

Трансфери (Відділення)

PreviousФільтр по відділенню

Last updated 1 year ago

Отримання списку трансферів по відділенню

Створення трансферу в рамках відділення

Підтверження трансферу в рамках відділення

Отримання списку трансферів по відділенню

Оновлення трансферу по відділенню

🛠️

Get branch payments list

get

Get branch payments list with filter

Path parameters
counterparty_guidstringRequired

Counterparty GUID

Query parameters
receiver_counterpartystringOptional

Receiver counterparty GUID

sender_counterpartystringOptional

Sender counterparty GUID

guidsstring[]Optional

Payment GUIDs

sender_idsstring[]Optional

Payment sender ids

receiver_idsstring[]Optional

Payment receiver ids

min_amountintegerOptional

Minimal amount

max_amountintegerOptional

Maximum amount

statusesstring[]Optional

Payment statuses

asset_issuersstring[]Optional

Asset issuers

asset_codesstring[]Optional

Asset codes

min_created_atstringOptional

ISO date

max_created_atstringOptional

ISO date

min_updated_atstringOptional

ISO date

max_updated_atstringOptional

ISO date

categorystringOptional

Category

orderstring · enumOptional

sorting order

Possible values:
offsetintegerOptional

offset

limitintegerOptional

limit

Responses
200
OK
application/json
400
json with error msg
application/json
get
GET /api/v1/counterparty/{counterparty_guid}/branch/{branch_guid}/payments HTTP/1.1
Host: your_host
Accept: */*
{
  "payments": [
    {
      "amount": 1,
      "asset_code": "text",
      "asset_issuer": "text",
      "category": "text",
      "category_guid": "text",
      "created_at": "text",
      "deleted_at": "text",
      "fee": 1,
      "guid": "text",
      "purpose": "text",
      "receiver_account_account_kind": "text",
      "receiver_counterparty": "text",
      "receiver_id": "text",
      "sender_account_account_kind": "text",
      "sender_counterparty": "text",
      "sender_id": "text",
      "status": "CREATED",
      "stellar_info": {
        "hash": "text"
      },
      "target_balance": 1,
      "updated_at": "text"
    }
  ],
  "total": 1
}

Get branch payment

get

Get branch payments with filter

Path parameters
counterparty_guidstringRequired

Counterparty GUID

branch_guidstringRequired

Branch GUID

payment_guidstringRequired

Payment GUID

Responses
200
OK
application/json
400
json with error msg
application/json
get
GET /api/v1/counterparty/{counterparty_guid}/branch/{branch_guid}/payments/{payment_guid} HTTP/1.1
Host: your_host
Accept: */*
{
  "amount": 1,
  "asset_code": "text",
  "asset_issuer": "text",
  "category": "text",
  "category_guid": "text",
  "created_at": "text",
  "deleted_at": "text",
  "fee": 1,
  "guid": "text",
  "purpose": "text",
  "receiver_account_account_kind": "text",
  "receiver_counterparty": "text",
  "receiver_id": "text",
  "sender_account_account_kind": "text",
  "sender_counterparty": "text",
  "sender_id": "text",
  "status": "CREATED",
  "stellar_info": {
    "hash": "text"
  },
  "target_balance": 1,
  "updated_at": "text"
}
  • Отримання списку трансферів по відділенню
  • GETGet branch payments list
  • Створення трансферу в рамках відділення
  • POSTCreate branch payment
  • Підтверження трансферу в рамках відділення
  • POSTConfirm Branch Payment
  • Отримання списку трансферів по відділенню
  • GETGet branch payment
  • Оновлення трансферу по відділенню
  • PUTUpdate branch payment

Create branch payment

post

Create branch payment

Path parameters
counterparty_guidstringRequired

Counterparty GUID

branch_guidstringRequired

Branch GUID

Body
amountnumberOptional

amount of tokens to transfer

asset_codestringOptional

asset code

asset_issuerstringOptional

address in Stellar that issues tokens

category_guidstringOptional

payment category

purposestringOptional
receiver_idstringOptional

guid of receiver account

sender_idstringOptional

guid of sender account

target_balancenumberOptional

account balance after operation

Responses
200
OK
application/json
400
json with error msg
application/json
post
POST /api/v1/counterparty/{counterparty_guid}/branch/{branch_guid}/payments HTTP/1.1
Host: your_host
Content-Type: application/json
Accept: */*
Content-Length: 153

{
  "amount": 1,
  "asset_code": "text",
  "asset_issuer": "text",
  "category_guid": "text",
  "purpose": "text",
  "receiver_id": "text",
  "sender_id": "text",
  "target_balance": 1
}
{
  "guid": "text"
}

Confirm Branch Payment

post

Confirm branch payment

Path parameters
counterparty_guidstringRequired

Counterparty GUID

branch_guidstringRequired

Branch GUID

Body
bank_guidstringOptional

Counterparty's GUID (receiver's bank). If it is not provided, the payment will be considered an internal transfer.

guidstringOptional

Payment's GUID

Responses
200
OK
application/json
Responseobject
400
json with error msg
application/json
post
POST /api/v1/counterparty/{counterparty_guid}/branch/{branch_guid}/payments/confirm HTTP/1.1
Host: your_host
Content-Type: application/json
Accept: */*
Content-Length: 34

{
  "bank_guid": "text",
  "guid": "text"
}
{}

Update branch payment

put

Update branch payment

Path parameters
counterparty_guidstringRequired

Counterparty GUID

branch_guidstringRequired

Branch GUID

payment_guidstringRequired

Payment GUID

Body
amountnumberOptional
asset_codestringOptional
asset_issuerstringOptional
purposestringOptional
receiver_idstringOptional
sender_idstringOptional
statusstring · enumOptionalPossible values:
Responses
200
OK
application/json
Responseobject
400
json with error msg
application/json
put
PUT /api/v1/counterparty/{counterparty_guid}/branch/{branch_guid}/payments/{payment_guid} HTTP/1.1
Host: your_host
Content-Type: application/json
Accept: */*
Content-Length: 130

{
  "amount": 1,
  "asset_code": "text",
  "asset_issuer": "text",
  "purpose": "text",
  "receiver_id": "text",
  "sender_id": "text",
  "status": "CREATED"
}
{}