Skip to content

Создать карточку пользователя ​

Подробности конечной точки ​

Метод: POST
URL: BASE_URL/merchant/userCard/createUserCard/
Заголовок:

http
Authorization: Bearer < ACCESS_TOKEN >

Тело запроса ​

ПоляТипТребуетсяОписание
userIdstringДаидентификатор пользователя, сгенерированный из системы Merchant
cardNumberstringда9860000000000000
expireDatestringдаYYMM
phoneNumberstringнет+998********
smsdictнет
json
{
  "userId": "string",
  "cardNumber": "string",
  "expireDate": "string",
  "phoneNumber": "string",
}

Успешный ответ ​

json
{
  "result": {
    "cid": "78a353ww-c4ff-42ee-qq0f-2a73baa5db4f",
    "otpSentPhone": "********0000"
  },
  "error": null
}

OTP отправляет процессинговый центр карты

  • Код OTP отправляет процессинговый центр Uzcard / Humo, а не Paylov или мерчант.
  • SMS приходит на номер телефона, привязанный к карте (в замаскированном виде возвращается в otpSentPhone).
  • Отправителем SMS будет процессинговый центр (например, UZCARD или HUMO), а в тексте сообщения может не быть названия мерчанта. В этом случае обратитесь к сотрудникам Paylov: они привяжут к мерчанту SMS name, и название мерчанта будет дополнительно отображаться в OTP SMS.
  • Если на карте не подключено SMS-информирование, OTP не будет доставлен.

Рекомендация: перед запросом кода покажите пользователю сообщение, например: "Код подтверждения будет отправлен Uzcard/Humo на номер телефона, привязанный к вашей карте: ********0000."

Ответ об ошибке ​

json
{
  "result": null,
  "error": {
    "code": "validation_error",
    "message": "validation_error",
    "data": {
      "cardNumber": [
        "invalid_card_number"
      ]
    }
  }
}