ЮKassa: POST /personal_data — Создание персональных данных

Используйте этот запрос, чтобы создать в ЮKassa объект персональных данных. Укажите тип данных (цель, для которой они будут использоваться) и информацию о пользователе: имя, фамилию, отчество и другие данные в зависимости от выбранного типа. Идентификатор созданного объекта персональных данных используйте в запросе на создание выплаты.

Документация: https://yookassa.ru/developers/api#create_personal_data

Параметр	Где	Тип	Обяз.	Описание
`Idempotence-Key`	header	string	да	Ключ идемпотентности. Рекомендуется использовать строку вида UUID v7
`type`	body	string (payout_statement_recipient, sbp_payout_recipient)	да	Тип персональных данных — цель, для которой вы будете использовать данные. Возможные значения: sbp_payout_recipient — выплаты с проверкой получателя (только для выплат через СБП); payout_statement_recipient — выплаты с данными получателя для выписок из отчета о выплатах.
`metadata`	body	object	нет	Любые дополнительные данные, которые нужны вам для работы (например, ваш внутренний идентификатор заказа). Передаются в виде набора пар «ключ-значение» и возвращаются в ответе от ЮKassa. Ограничения: не больше 16 ключей, имя ключа — не больше 32 символов, значение ключа — не больше 512 символов, тип данных — строка в формате UTF-8.
`last_name`	body	string	да	Фамилия пользователя.
`first_name`	body	string	да	Имя пользователя.
`middle_name`	body	string	нет	Отчество пользователя. Обязательный параметр, если указано в паспорте.
`birthdate`	body	string	нет	Дата рождения. Указывается в формате ISO 8601.

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

{
  "type": "sbp_payout_recipient",
  "last_name": "Иванов",
  "first_name": "Иван"
}

Пример ответа:

{
  "id": "pd-22e12f66-000f-5000-8000-18db351245c7",
  "status": "waiting_for_operation",
  "type": "sbp_payout_recipient",
  "created_at": "string"
}

Базовые URL

Основной: https://api.yookassa.ru/v3

Авторизация

Тип: Basic Auth

HTTP Basic Auth: имя пользователя — идентификатор магазина (shopId, раздел Настройки — Магазин) или шлюза для выплат (agentId, раздел Настройки выплат), пароль — секретный ключ (раздел Интеграция — Ключи API). Для тестового магазина ключ выпускается автоматически. Участники партнерской программы используют OAuth 2.0 и передают Bearer-токен. Секретный ключ и OAuth-токен нельзя публиковать.

curl https://api.yookassa.ru/v3/payments/{payment_id} \
  -u <Идентификатор магазина>:<Секретный ключ>

Нюансы

capture по умолчанию false: без capture: true платеж останется в статусе waiting_for_capture и в момент expires_at отменится автоматически, деньги вернутся покупателю.
Для POST и DELETE обязателен заголовок Idempotence-Key — до 64 символов, рекомендуется UUID. Повтор с тем же ключом в течение 24 часов вернет результат первого запроса; для новой операции нужен новый ключ.
HTTP 500 не значит, что операция не прошла: результат неизвестен. Повтори запрос с теми же данными и тем же ключом идемпотентности или запроси объект через GET.
Возврат покупателя на return_url не означает успешную оплату — статус проверяй на сервере или по HTTP-уведомлению.
Сумма — строка с точкой и двумя знаками: "1000.00", вместе с кодом валюты.
Методы /webhooks работают только с OAuth-токеном в партнерской программе. Обычный магазин настраивает уведомления в личном кабинете.
Вернуть платеж можно в течение трех лет с момента создания. Комиссия ЮKassa за платеж не возвращается.
Для Чеков от ЮKassa частичная предоплата, аванс и кредит не поддерживаются.

Если этого недостаточно — официальная документация: https://yookassa.ru/developers/api#create_personal_data Вся интеграция одним документом: https://mcp-everything.ru/integrations/yookassa.md