Create a new issuer

Updated on 12 Jun 2020

Description

The issuer is the payment unit of the system – the types of units/currencies that are available in the system.

It can be a separate electronic currency, with reference to real currencies or without it, also bonuses units, etc. Currently, we have Issuers which are connected to real types of currencies: USD, EUR, GBP etc. (obtain, create, update issuers)

A User or External Entity on behalf of a User with role permission ISSUER_MANAGER sends a request to Endpoint “Create a new issuer”.

Actors

  1. External Entity that can interact with System Operator API acting as a registered System Operator User with permissions: ISSUER_MANAGER.
  2. System Operator running “SDK.Finance” software and exposing portfolio of financial APIs.

Preconditions

  1. The user must have a System Operator profile with sufficient access privileges.

Basic Flow

By default, this flow assumes that External Entity sends Requests to System Operator Endpoints and System Operator sends back Responses to External Entity.

  1. External Entity sends a request to Endpoint “Create a new issuer”.

Endpoint URL: https://sdkfinance.app/api/ui/#!/Issuers/Create_issuer

Parameters:

Authorization – authorization token

Request body example:



   "snPrefix":"string",

   "currencyCode":"string",

   "name":"string",

   "description":"string",

   "active":false,

   "orderNumber":0,

   "orderQuote":0

}
  1. System Operator returns new Issuer information to External Entity. (See Result example below)

Optional Flow with Web Browser UI

1.A user sends a request to Endpoint “Create a new issuer”.

Endpoint URL: https://sdkfinance.app/api/ui/#!/Issuers/Create_issuer

Parameters:

Authorization – authorization token

Reauest body example:



   "snPrefix":"string",

   "currencyCode":"string",

   "name":"string",

   "description":"string",

   "active":false,

   "orderNumber":0,

   "orderQuote":0

}

 

  1. System Operator returns new Issuer information to User (See Result example below).

Post Conditions

new Issuer is available.

Result example



   "issuer":{ 

      "id":"string",

      "sn":"string",

      "name":"string",

      "description":"string",

      "orderNumber":0,

      "orderQuote":0,

      "active":false,

      "currency":{ 

         "code":"string",

         "digitalCode":"string",

         "symbol":"string",

         "name":"string",

         "description":"string"

      }

   },

   "status":"ok",

   "message":"string"

}