Трансфер (перерозподілення ідентифікаторів)

Щоб почати користуватися функцією трансферу, необхідно створити цифрові записи до ідентифікаційнийного ідентифікатору. Коли в обліковому записі з’являються цифорві записи, можна розподілити їх між обліковими записами Процесингового іднетифікатору та обліковими записами Клієнтів.

Система надає такі способи роботи з трансфером ідентифікаторів:

#get-payment

#create-payment

#confirm-payment

#get-payments-list

Існують маршрути трансферів всередині 1 контрагента:

• від Ідентифікаційного ідентифікатору до Процесингового ідентифікатору;

• з Процесингового ідентифікатору до облікового запису Клієнта;

• від Клієнта до Клієнта;

• з Процесингового ідентифікатору на Ідентифікаційний ідентифікатор;

• від Клієнта до Процесингового ідентифікатору Банку.

Для зовнішнього трансферу (2 контрагенти) рекомендовані такі типи платежів:

• з Процесингового ідентифікатору на з Процесинговий ідентифікатор іншого Контрагента;

• від Клієнта вашого Контрагента до Клієнта іншого Контрагента.

Отримати оплату

Get payment

get

Get payments with filter

Path parameters

counterparty_guidstringRequired

Counterparty GUID

payment_guidstringRequired

Payment GUID

Query parameters

with_stellar_infobooleanOptional

Include stellar info

Responses

get

HTTPcURLJavaScriptPython

GET /api/v1/counterparty/{counterparty_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"
}

Response example

{
    "guid": "37f6b441-0906-46b6-9349-e742531f4eb7",  //payment GUID
    "asset_issuer": "GC63UKIHPPR4F74IZ6BU24ZCJXHO4Y4C2KAUATDAQQFXKRW5FT6AJKYS",
    "asset_code": "UAH",
    "sender_id": "7f971dc7-0fd2-4c5c-926d-75a6d6088535",   //account_guid
    "sender_counterparty": "ac75f1a6-0abe-11ee-be56-0242ac120002",
    "sender_account_account_kind": "root",        //enum(customer, processing, emission)
    "receiver_id": "d5085e37-1a50-11ee-bd5f-3a6aa4436fee",
    "receiver_counterparty": "130a613a-d5ba-42fd-9915-ae289f392def",
    "receiver_account_account_kind": "emission",  //enum(customer, processing, emission)
    "amount": 100,
    "status": "CONFIRMED",     // enum(CREATED, CONFIRMED)
    "fee": 0,
    "stellar_info": {
        "hash": "e2302182308fad32018e57095537d7850a085ae8034df07224f8d5da79c1662d"
    },
    "created_at": "2023-08-18T12:49:33.774546Z",
    "updated_at": "2023-08-18T12:49:33.774546Z",
    "deleted_at": null
}

За допомогою параметра hash ви можете побачити цю операцію в Stellar.Expert.

Здійснити трансфер

Трансфер здійснюється в 2 кроки: спочатку необхідно створити чернетку запису за допомогою «Створити трансфер». Коли це буде зроблено, потрібне підтвердження цього трансферу.

Створити трансфер

Попередня умова: на обліковому записі відправника має бути необхідна кількість ідентифікаторів перед створенням трансферу.

Create payment

post

Create payment

Path parameters

counterparty_guidstringRequired

Counterparty 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

post

HTTPcURLJavaScriptPython

POST /api/v1/counterparty/{counterparty_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"
}

Підтвердження трансферу

Після створення трансферу необхідно підтвердити трансфер.

Перед підтвердженням переконайтеся, що трансферу вже створений, відповідний ідентифікатор має бути використаний у тілі запиту.

bank_guid є обов'язковим лише для трансферу іншому Контрагенту.

Confirm Payment

post

Confirm payment

Path parameters

counterparty_guidstringRequired

Counterparty 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

Responseobject

post

HTTPcURLJavaScriptPython

POST /api/v1/counterparty/{counterparty_guid}/payments/confirm HTTP/1.1
Host: your_host
Content-Type: application/json
Accept: */*
Content-Length: 34

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

{}

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

Для того, щоб отримати список трансферів, необхідно зробити наступний запит:

Get payments list

get

Get 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

external_idstringOptional

External transaction id

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

category_guidstringOptional

Category's guid

orderstring · enumOptional

sorting order

Possible values:

offsetintegerOptional

offset

limitintegerOptional

limit

Responses

get

HTTPcURLJavaScriptPython

GET /api/v1/counterparty/{counterparty_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
}