Sign in
Способы оплаты

Создание способа оплаты

Используйте этот запрос, чтобы создать в ЮKassa объект способа оплаты: https://yookassa.ru/developers/api#payment_method_object. В запросе необходимо передать код способа оплаты, который вы хотите сохранить, и при необходимости дополнительные параметры, связанные с той функциональностью, которую вы хотите использовать. Идентификатор созданного способа оплаты вы можете использовать при проведении автоплатежей: https://yookassa.ru/developers/payment-acceptance/scenario-extensions/recurring-payments/create-recurring или выплат: https://yookassa.ru/developers/payouts/scenario-extensions/multipurpose-token.

post/payment_methods

Headers

Idempotence-Keystring required

Request body

type'bank_card' required
client_ipstring

IPv4 или IPv6-адрес пользователя. Если не указан, используется IP-адрес TCP-подключения.

Example request

{
  "holder": {
    "gateway_id": "456"
  },
  "confirmation": {
    "type": "redirect",
    "enforce": true,
    "locale": "ru_RU"
  },
  "card": {
    "number": "5105105105105100",
    "expiry_year": "2017",
    "expiry_month": "07",
    "cardholder": "John Smith"
  }
}

Response

Запрос успешно обработан

type'bank_card' required

Тип способа оплаты.

idstring required

Идентификатор сохраненного способа оплаты.

savedboolean required

Признак сохранения способа оплаты для автоплатежей: https://yookassa.ru/developers/payment-acceptance/scenario-extensions/recurring-payments/pay-with-saved. Возможные значения: true — способ оплаты сохранен для автоплатежей и выплат; false — способ оплаты не сохранен.

status'pending' | 'active' | 'inactive' required

Статус проверки и сохранения способа оплаты. Возможные значения: pending — ожидает действий от пользователя; active — способ оплаты сохранен, его можно использовать для автоплатежей или выплат; inactive — способ оплаты не сохранен: пользователь не подтвердил привязку платежного средства или при сохранении способа оплаты возникла ошибка. Чтобы узнать подробности, обратитесь в техническую поддержку ЮKassa.

titlestring

Название способа оплаты.

Example response

{
  "type": "bank_card",
  "id": "1da5c87d-0984-50e8-a7f3-8de646dd9ec9",
  "saved": true,
  "status": "active",
  "holder": {
    "account_id": "123",
    "gateway_id": "456"
  },
  "title": "Основная карта",
  "confirmation": {
    "type": "redirect",
    "enforce": true
  },
  "card": {
    "first6": "427918",
    "last4": "7918",
    "expiry_year": "2017",
    "expiry_month": "07",
    "card_product": {
      "code": "MCP",
      "name": "MIR Privilege"
    },
    "issuer_country": "RU",
    "issuer_name": "Sberbank"
  }
}

Changes