Navigation

Loymax, 2024

Gift certificate import

Since version 2022.1 it is now possible to import ready-made gift certificates created outside of the Loymax system.

Importing money certificates involves the following steps:

Certificate type creation

You need to create certificate type to further issue and order certificates. The type of denomination and its value can be any.

Template Creation

You need to create Template to further issue and order certificates.

Creation of certificate issue and ordering

You need to create Issue and Order certificates (without pressing Execute).

Creation of a ruble account for a legal entity

Make sure that the legal entity has a ruble account. If a partner does not have a ruble account, it is necessary to add it via MMP or via API

Import certificates

Cash certificates are imported using API for cash certificates. To do this, you need to prepare a CSV file with information about money certificates. It is possible to get data about the number of import errors using a special API method.

Notes:

  1. It is recommended to import no more than 100 certificates in one batch.
  2. If errors occur during the import, you can make corrections to the source file and repeat the import procedure. Certificates that were loaded without errors will be skipped when the import is restarted.

Import file requirements

  • Certificates must be uploaded to the System in CSV; file format
  • Certificate identifiers which can be used during import: 
    • The unique number printed on the certificate (Number);
    • A unique barcode printed on the certificate (Barcode);
    • Information embedded in the magnetic strip (Strip1, Strip2, Strip3);
    • QR code printed on the certificate (QRcode).
  • Possible states of imported money certificates:
    • Prepared;
    • Activated;
    • Redeemed;
    • Canceled;
    • Redunded;
    • Expired.
  • The certificate balance (Amount), i.e. the amount in the certificate account, can be anything in the range of 0...100000000, including fractional (rubles and kopecks).
  • The dates of activation (ActivationDate) and expiration (ExpirationDate) must be transmitted in the format YYYYY-MM-DD.

You cannot import money certificates that are in a state that indicates an incomplete process: Activating or Returning (Refunding).

Example of an imported CSV file with money certificates:

Number;BarCode;Strip2;Status;Amount;ActivationDate;ExpirationDate
7770002105606220001;7770002105606220001;7770002105606227847=26067229740000001;Activated;555;2022-11-25;2023-11-25
7770002105606220002;7770002105606220002;7770002105606227848=26067229740000002;Activated;345;2022-11-25;2023-11-25
7770002105606220003;7770002105606220003;7770002105606227849=26067229740000003;Activated;100;2022-10-25;2024-10-25
7770002105606220004;7770002105606220004;7770002105606227850=26067229740000004;Prepared;1000;2022-10-25;2024-10-25

Note: you can only import data about a redeemed certificate (in Redeemed state) if the certificate is a one-time certificate or if the certificate amount (Amount) is zero.

Updating information about certificates

If changes have been made after importing money certificates, e.g. certificates have been sold, redeemed, cancelled, etc., it is necessary to upload a CSV file with updated data on the certificates whose status has been changed.

You can also perform batch activation of money certificates by transferring a file with money certificates in the state Activated. Thus, it is possible to issue a large number of certificates at one time.

For example, the certificate with number 7770002105606220002 has been redeemed, so you must transmit the updated status (Redeemed) and the redemption date - RedemptionDate in the format YYYY-MM-DD. The certificate with the number 7770002105606220004 has been activated, its status has changed from Activated to Activated, the data about the change should also be transmitted in the import file. An example CSV file for these certificates is shown below:

Number;BarCode;Strip2;Status;Amount;ActivationDate;ExpirationDate;RedemptionDate
7770002105606220002;7770002105606220002;7770002105606227848=26067229740000002;Redeemed;0;2022-11-25;2023-11-25;2022-12-12
7770002105606220004;7770002105606220004;7770002105606227850=26067229740000004;Activated;1000;2022-10-25;2024-10-25

Note: when updating certificate data, you can transmit any one certificate identifier.

 

Created 13/11/2022 23:27
Last edited 26/09/2023 00:38

News
Version history
Tags
Glossary
Site