Setting up software-based cash register

How to set up SBCR

1. Register your cash register with our SBCR service provider

   Available SBCR services
   Currently, the only available service is Cash Desk

2. Add new parameters to API request

In addition to the standard set of parameters for payment requests, it is required to include product data for all payments and refunds (purchase, auth, capture, and refund transactions).

Parameter	Type	Required	Description
products.id	UUID	✅	Unique product identifier
products.name	String	✅	Product name
products.amount	Number	✅	Price per unit of goods/work/service
products.qty	Number	✅	Quantity (total payment amount = products.qty * products.amount)
products.unit	String	✅	Unit of measurement (allowed values are kg, m, pc, l)
products.bar_code	String		Product barcode (optional for fiscalization but mandatory for the "National cashback" program)
customer_email	String	✅	Customer’s email
products.taxes.type	String		Type of tax (allowed values are vat, non-vat). If the business entity is not a VAT payer, the value non-vat must be provided.
products.taxes.prc	Number		Tax rate % (valid values: 0, 7, 14, 20)

Example of Body request:

{
  "pos_id": "00000000-0000-0000-0000-000000000000",
  "mode": "direct",
  "method": "purchase",
  "amount": 100,
  "currency": "UAH",
  "cc_number": "4111111111111111",
  "exp_month": 12,
  "exp_year": 24,
  "card_cvv": "123",
  "order_id": "123456789",
  "description":"Опис товару",
  "payway": "cc",
  "order_3ds_bypass": "supported",
  "customer_email": "[email protected]",
  "products": [{
    "id": "1",
    "name": "product name",
    "unit": "pc",
    "bar_code":"4876534567183",
    "amount": 50,
    "taxes": [{"type":"vat", "prc": 20}],
    "qty": 2
  }],
  "server_url": "http://callback-stub:9000/consume"
}

caution

Prior to proceeding to the next step, it is imperative to make the above-mentioned changes to the API integration. Failure to introduce the necessary changes while setting up the SBCR will result in transaction failures due to missing mandatory parameters.

1. Set up SBCR in merchant portal

1. Open the general settings of the merchant account and select the SBCR option.

2. Click the New Configuration button.

3. Fill out the form:

   • Configuration name: any value of your choice.
   • Service provider: the provider of the SBCR service you register your cash register with (currently, only Cash Desk is available).
   • Cash register identifier (SBCR ID):
     An example value of the Cash Desk parameters "num_fiscal": “100000000000”
   • API token from the SBCR service provider:
     An example value of the Cash Desk parameters “api_token” : "00000000-0000-0000-0000-000000000000
   • Scope of application: select a required legal entity or private entrepreneur
   • Enable the application of SBCRs for payments switcher as it is shown in the image below.

4. Check the entered data and submit the form.
   After submitting the form the SBCR application will be enabled for the corresponding configuration.

   

5. Add a Digital Signature (DS) for signing fiscal receipts of the respective business entity.
   

   • In the SBCR section, select the Digital signatures tab.
   • Choose the option "Add digital signatures".
   • Enter the desired name for the DS and the business entity it belongs to.
   • Upload the key file and enter its password.
   • Confirm the upload by clicking the "Submit" button.

After this, subsequent fiscal receipts of the respective business entity will be signed with the uploaded key until it is replaced or deleted, or until its expiration date.

info

If you do not utilize the merchant portal, please reach out to your account manager or our support team at [email protected] to enable the SBCR feature.