Создание ссылки для привязки

Когда пользователь нажимает кнопку «Добавить карту», backend партнёра запрашивает одноразовую ссылку для привязки (bindUrl).

Endpoint details

Method: POST
URL: BASE_URL/merchant/userCard/createBindLink/
Header:

Authorization: Bearer < ACCESS_TOKEN >
Content-Type: application/json

Request body

Fields	Type	Required	Description
userId	string	Yes	ID пользователя в системе партнёра (внутренний ID, задаётся партнёром)
returnUrl	string	No	Адрес для возврата после завершения webview

{
  "userId": "partner-user-10234",
  "returnUrl": "https://partner-app.example/wallet/cards"
}

Пример запроса

curl -X POST https://gw2.paylov.uz/merchant/userCard/createBindLink/ \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "partner-user-10234",
    "returnUrl": "https://partner-app.example/wallet/cards"
  }'

Success response

{
  "result": {
    "token": "pR3x...kLq9",
    "bindUrl": "https://my.paylov.uz/card-bind/?token=pR3x...kLq9",
    "expiresAt": "2026-10-30T12:20:00+00:00"
  },
  "error": null
}

Field	Type	Description
token	string	Одноразовый токен. Используется для идентификации запроса в webhook и при проверке статуса
bindUrl	string	Ссылка, которая открывается в webview
expiresAt	string	Срок действия ссылки (ISO 8601)

Примечание

bindUrl — одноразовая, действует около 20 минут и предназначена только для привязки одной карты. Для привязки новой карты каждый раз нужно запрашивать новую ссылку.

Fail response

{
  "result": null,
  "error": {
    "code": "permission_denied",
    "message": "permission_denied"
  }
}

Следующий шаг: откройте bindUrl в webview — Привязка карты.