B2C

Создание перевода с карты на карту

Пром POST https://baas.alfabank.ru/api/pp/v1/transfers/c2c

Песочница POST https://sandbox.alfabank.ru/api/pp/v1/transfers/c2c

Scope

c2c-transfers

Описание

В результате данного запроса пользователь может совершить перевод со своей кобрединговой карты на карту другого клиента. Для этого ему необходимо:

  1. 1.
    Выбрать карту с которой будет совершён перевод;
  2. 2.
    Указать карту, на которую будет совершён перевод (также её можно сохранить в профиле для будущих переводов (см. подробности в описании метода Сохранение новой карты для перевода));
  3. 3.
    Указать сумму перевода;
  4. 4.

Параметры запроса

HEADERS
Атрибут
Описание
Accept
stringrequired

application/json

Authorization
stringrequired

Bearer {access_token}, полученный по Authorization Code Flow

Content-Type
stringrequired

application/json

Device-Model
stringrequired

Модель устройства клиента

Device-Id
stringrequired

Идентификатор устройства клиента

X-Real-Ip
stringrequired

IP адрес клиента

BODY
Атрибут
Описание
objectrequired

Сумма операции

value
integerrequired

Сумма операции в минорных единицах

currency
stringrequired

Код валюты

minorUnits
integerrequired

Минорные единицы

objectrequired

Информация об отправителе перевода

cvv
stringoptional

CVV-код карты отправителя

cardId
stringrequired

Идентификатор карты отправителя

objectrequired

Информация о получателе перевода

type
stringrequired

Тип идентификатора карты получателя. Принимает возможные значения: CARD_ID - идентификатор карты; CARD_NUMBER - номер карты

value
stringrequired

Идентификатор карты (номер | ID)

Пример запроса
curl -X POST https://baas.alfabank.ru/api/pp/v1/transfers/c2c \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}' \
  -H 'Content-Type: application/json' \
  -H 'Device-Model: aabbcc' \
  -H 'Device-Id: aabbcc' \
  -H 'X-Real-Ip: 10.1.100.2' \
  -d '{
  "amount": {
	"value": 200,
    "currency": "RUB",
    "minorUnits": 6
  },
  "sender": {
    "cvv": "123",
    "cardId": "1234"
  },
  "recipient": {
    "type": "CARD_NUMBER",
    "value": "1111222233334444"
  }
}'

Параметры ответа

Пример ответа 200 (ОК)
{
  "transferMetaData": "eyJhbGciOiJIUzI1NiJ9",
  "confirmationInfo": {
    "type": "THREE_DS",
    "threeDs": {
      "md": "MD",
      "paReq": "PAREQ",
      "accessUrl": "3DS_URL",
      "termUrl": "https://click.alfabank.ru/adfform/auth.jspx"
    }
  }
}
transferMetaData
stringrequired

JWT метаданные для перевода

objectrequired

Данные для подтверждения перевода

type
stringrequired

Тип подтверждения перевода. Принимает возможные значение: THREE_DS - подтверждение через 3DS

objectrequired

Данные для подтверждения через 3DS

md
stringrequired

Message Digest (передается в 3DS)

paReq
stringrequired

Реквест в 3DS

accessUrl
stringrequired

URL 3DS

termUrl
stringrequired

URL страницы аутентификации

Пример ответа 200 (ОК)
{
  "transferMetaData": "eyJhbGciOiJIUzI1NiJ9",
  "confirmationInfo": {
    "type": "THREE_DS",
    "threeDs": {
      "md": "MD",
      "paReq": "PAREQ",
      "accessUrl": "3DS_URL",
      "termUrl": "https://click.alfabank.ru/adfform/auth.jspx"
    }
  }
}
error
stringrequired

Код ошибки. Принимает возможные значения: invalid_request - Неверные входные параметры запроса

error_description
stringoptional

Описание ошибки

Пример ошибки 400 (Bad Request)
{
  "error": "invalid_request",
  "error_description": "Authorization header is not present in request headers"
}
error
stringrequired

Код ошибки. Принимает возможные значения: invalid_token - Предоставленный токен просрочен, отозван, имеет неправильный формат или недействителен по другим причинам

error_description
stringoptional

Описание ошибки

Пример ошибки 401 (Unauthorized)
{
  "error": "invalid_token",
  "error_description": "The access token provided is expired, revoked, malformed, or invalid for other reasons"
}
error
stringrequired

Код ошибки. Принимает возможные значения: insufficient_scope - у пользователя нет прав на использование запрашиваемого сервиса, доступ к которому не предусмотрен настройками scope; access_denied - доступ к счету запрещен

error_description
stringoptional

Описание ошибки

Пример ошибки 403 (Forbidden)
{
  "error": "insufficient_scope",
  "error_description": "The request requires higher privileges than provided by the access token"
}
error
stringrequired

Код ошибки. Принимает возможные значения: unknown_endpoint - Эндпоинт не найден или неактивен

error_description
stringoptional

Описание ошибки

Пример ошибки 404 (Not Found)
{
  "error": "unknown_endpoint",
  "error_description": "Endpoint is not found or not active"
}
Нет тела ответа
error
stringrequired

Код ошибки. Принимает возможные значения: internal_error - Внутренняя ошибка сервиса при выполнении обработки запроса

error_description
stringoptional

Описание ошибки

Пример ошибки 500 (Internal Server Error)
{
  "error": "internal_error",
  "error_description": "Internal server error"
}
Нет тела ответа

Значения параметров ошибок могут изменяться. Рекомендуем предусмотреть стандартную обработку ошибок, не описанных в текущей версии документации.