Gift Cards

Intrioduction

The Gift Card Product is provided by a partner bank on the basis of the Prepaid card product.

In order to start working with this product it is necessary to request integration with this product through a personal manager and sign an agreement with the partner bank.

Gift cards are provided both as a mass issue and on the individual basis following a customer’s request. All liabilities are paid at the moment the card is issued from the merchant’s funds that are put on the account in advance.

All cards are issued as inactive and cannot be used by the buyer until the card is fully activated and the telephone number and personal data are submitted.

Card issue process
card issuance process diagram
Product list

The method allows to get the list of products that are available for issue.
The method returns the gift card products only available to the merchant
Request body

{
}
Response

{
  "datetime": "2022-05-01 12:01:15",
  "status": 0,
  "product_list": [
    {
      "code": 1,
      "name": "Карты Альфа-Банка",
      "name_en": "AlfaBank card"
      "currency": "USD",
      "balance": 50,
      "image": "url"
    },
    {
      "code": 2,
      "name": "Карты Сбербанка",
      "name_en": "Sberbank card"
      "currency": "USD",
      "balance": 100,
      "image": "url"
    }
  ]
}

Field description
Card issue

The method allows to issue a gift card by the partner bank.

If the card issue operation is successful, an SMS with the confirmation code will be sent to the designated telephone number.
Request body

{
  "cardholder_name": "IVANOV IVAN IVANOVICH",
  "phone": 79651234567,
  "product_code": 1
}

Field description
card_id is used only in case of mass card issue when the merchant gets card_id in advance
Response

{
  "datetime": "2022-05-01 12:01:15",
  "status": 0,
  "card_id": 555
}

Field description
Card confirmation

Upon request to issue a card issue it is necessary to confirm the customer’s telephone number through an OTP code sent in an SMS.

If the operation is successful the bank activates the card and sends a message to the user with the missing card number information, CVV, EXP DATE, denomination/currency.
Request body

{
  "otp": "1234",
  "card_id": 555
}
Field description
Response

{
  "datetime": "2022-05-01 12:01:15",
  "status": 0,
  "card_status": 1,
  "card_currency": "USD",
  "card_balance": 100, 
  "card_mask": "1234********5678"
}

Field description
Resending of OTP

If there is an error ‘Wrong OPT’ while the card issue is being confirmed or the customer has not received an sms, an OTP code can be repeatedly requested..
Request body

{
  "card_id": 555
}
Field description
Response

{
  "datetime": "2022-05-01 12:01:15",
  "status": 0
}
Field description
Resending of card data

The method allows to repeat sending of an SMS with card data to the customer.
Request body

{
  "card_id": 555
}

Field description
Response

{
  "datetime": "2022-05-01 12:01:15",
  "status": 0
}
Field description
Card information

The method allows to get card information including card status
Request body

{
  "card_id": 555
}
Field description
Response

{
  "datetime": "2022-05-01 12:01:15",
  "status": 0,
  "card_status": 1,
  "card_currency": "USD",
  "card_balance": 100
}
Field description