Полоса
Полоса позволяет частным лицам и предприятиям принимать платежи через Интернет. Вы можете отслеживать клиентов, заказы, счета и многое другое.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Премия | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | Microsoft |
| URL |
Поддержка Microsoft LogicApps Поддержка Microsoft Power Automate Поддержка Microsoft Power Apps |
| Метаданные соединителя | |
|---|---|
| Publisher | Microsoft |
| Веб-сайт | https://stripe.com/ |
| Политика конфиденциальности | https://stripe.com/privacy |
Известные проблемы и ограничения
- Из-за ограничений API Stripe триггеры не могут обрабатывать более 100 событий в секунду.
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Ключ API | securestring | Ключ API | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
| Частота опросов триггеров | 1 | 120 секунд |
Действия
| Обновление клиента |
Обновляет указанный клиент, задав значения переданных параметров. |
| Обновление продукта |
Обновляет конкретный продукт, задав значения переданных параметров. |
| Получение клиента |
Возвращает сведения о указанном клиенте. |
| Создайте клиента. |
Создание нового клиента. |
| Создание продукта |
Создает новый продукт. |
Обновление клиента
Обновляет указанный клиент, задав значения переданных параметров.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор
|
id | True | string |
Идентификатор клиента. |
|
Description
|
description | string |
Произвольная строка, которую можно подключить к клиенту, будет не задана, если вы отправляете пустое значение. |
|
|
Адрес электронной почты
|
string |
Адрес электронной почты клиента будет не задан, если вы отправляете пустое значение. |
Возвращаемое значение
- Тело
- Customer_Response
Обновление продукта
Обновляет конкретный продукт, задав значения переданных параметров.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор
|
id | True | string |
Идентификатор продукта. |
|
Имя
|
name | True | string |
Имя продукта, которое должно отображаться клиенту. |
|
Active
|
active | boolean |
Независимо от того, доступен ли продукт в настоящее время для покупки. По умолчанию используется значение true. |
|
|
Заголовок
|
caption | string |
Краткое однострочный описание продукта, которое должно отображаться клиенту. |
|
|
Description
|
description | string |
Описание продукта, которое должно отображаться клиенту. |
|
|
Изображения
|
images | string |
Список до 8 URL-адресов изображений для этого продукта, предназначенный для отображения клиенту. |
|
|
Поставляемые
|
shippable | boolean |
Независимо от того, поставляется ли этот продукт (т. е. физические товары). По умолчанию используется значение true. |
|
|
URL
|
url | string |
URL-адрес общедоступной веб-страницы для этого продукта. |
Возвращаемое значение
- Тело
- Product_Response
Получение клиента
Возвращает сведения о указанном клиенте.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор
|
id | True | string |
Идентификатор клиента. |
Возвращаемое значение
- Тело
- Customer_Response
Создайте клиента.
Создание нового клиента.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Description
|
description | string |
Произвольная строка, которую можно подключить к клиенту, будет не задана, если вы отправляете пустое значение. |
|
|
Адрес электронной почты
|
string |
Адрес электронной почты клиента будет не задан, если вы отправляете пустое значение. |
Возвращаемое значение
- Тело
- Customer_Response
Создание продукта
Создает новый продукт.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Имя
|
name | True | string |
Имя продукта, которое должно отображаться клиенту. |
|
Идентификатор
|
id | string |
Идентификатор продукта. Должен быть уникальным. Если он не указан, идентификатор будет создан случайным образом. |
|
|
Active
|
active | boolean |
Независимо от того, доступен ли продукт в настоящее время для покупки. По умолчанию используется значение true. |
|
|
Заголовок
|
caption | string |
Краткое однострочный описание продукта, которое должно отображаться клиенту. |
|
|
Description
|
description | string |
Описание продукта, которое должно отображаться клиенту. |
|
|
Изображения
|
images | string |
Список до 8 URL-адресов изображений для этого продукта, предназначенный для отображения клиенту. |
|
|
Поставляемые
|
shippable | boolean |
Независимо от того, поставляется ли этот продукт (т. е. физические товары). По умолчанию используется значение true. |
|
|
URL
|
url | string |
URL-адрес общедоступной веб-страницы для этого продукта. |
Возвращаемое значение
- Тело
- Product_Response
Триггеры
| При добавлении заказа |
Активирует новый поток при добавлении заказа. |
| При добавлении клиента |
Активирует новый поток при добавлении клиента. |
| При добавлении платы |
Активирует новый поток при добавлении платы. |
| При добавлении элемента счета |
Активирует новый поток при добавлении элемента счета. |
При добавлении заказа
Активирует новый поток при добавлении заказа.
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор
|
id | string |
Идентификатор заказа. |
|
Сумма
|
amount | integer |
Положительное целое число в наименьшей денежной единице. |
|
Возвращенная сумма
|
amount_returned | integer |
Сумма в центах, возвращенная (может быть меньше, чем атрибут суммы на плату, если был выдан частичный возврат). |
|
Обвинение
|
charge | string |
Идентификатор платежа, используемого для оплаты заказа. Имеется, если состояние заказа оплачено, выполнено или возвращено. |
|
Создано
|
created | date-time |
Дата создания заказа. |
|
Валюта
|
currency | string |
3-буквенный код ISO, представляющий валюту, в которой был сделан заказ. |
|
Клиент
|
customer | string |
Клиент, используемый для заказа. |
|
Адрес электронной почты
|
string |
Адрес электронной почты клиента, размещающего заказ. |
|
|
Выбранный метод доставки
|
selected_shipping_method | string |
Метод доставки, выбранный в настоящее время для этого заказа, если таковой имеется. |
|
Состояние
|
status | string |
Текущее состояние заказа. Один из созданных, платных, отмененных, выполненных или возвращенных. |
|
Updated
|
updated | date-time |
Дата и время обновления заказа. |
При добавлении клиента
Активирует новый поток при добавлении клиента.
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор
|
id | string |
Идентификатор клиента. |
|
Счете
|
account_balance | integer |
Текущий баланс, если он есть, хранится в учетной записи клиента. |
|
Создано
|
created | date-time |
Дата создания клиента. |
|
Валюта
|
currency | string |
Валюта, взимаемая клиентом, может взиматься в целях регулярного выставления счетов. |
|
Преступник
|
delinquent | boolean |
Не удалось ли выполнить последнюю плату за последний счет клиента. |
|
Description
|
description | string |
Описание клиента. |
|
Скидка
|
discount | Discount |
Описывает текущую скидку, активную для клиента, если она есть. |
|
Адрес электронной почты
|
string |
Сообщение электронной почты клиента. |
При добавлении платы
Активирует новый поток при добавлении платы.
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор
|
id | string |
Идентификатор платы. |
|
Сумма
|
amount | integer |
Положительное целое число в наименьшей денежной единице (например, 100 центов для оплаты $ 1,00 или 100 для оплаты 100, 0-десятичной валюты), представляющей, сколько будет взиматься. |
|
Сумма возвращена
|
amount_refunded | integer |
Сумма в центах, возвращенная (может быть меньше, чем атрибут суммы на плату, если был выдан частичный возврат). |
|
Распознано
|
captured | boolean |
Если плата была создана без записи, это логическое значение представляет, остается ли он еще незапечатленным или с тех пор был захвачен. |
|
Создано
|
created | date-time |
Дата создания платы. |
|
Валюта
|
currency | string |
Трехбуквенный код валюты ISO, представляющий валюту, в которой была произведена плата. |
|
Клиент
|
customer | string |
Идентификатор клиента, за который взимается плата, если он существует. |
|
Description
|
description | string |
Описание платы. |
|
Код сбоя
|
failure_code | string |
Код ошибки, объясняющий причину сбоя заряда при наличии. |
|
Сообщение об ошибке
|
failure_message | string |
Сообщение пользователю, чтобы объяснить причину сбоя оплаты, если она доступна. |
|
Invoice
|
invoice | string |
Идентификатор счета, за который взимается плата, если она существует. |
|
Заказ
|
order | string |
Идентификатор заказа, за который взимается плата, если он существует. |
|
Состояние сети
|
outcome.network_status | string |
Возможные значения: approved_by_network, declined_by_network, not_sent_to_network и reversed_after_approval. |
|
Причина
|
outcome.reason | string |
Перечисленное значение, указывающее более подробное объяснение типа результата. |
|
Уровень риска
|
outcome.risk_level | string |
Оценка рискованности оплаты полосой. |
|
Сообщение о продавце
|
outcome.seller_message | string |
Читаемое человеком описание типа результата и причины, предназначенного для получателя платежа. |
|
Тип
|
outcome.type | string |
Возможные значения авторизованы, issuer_declined, заблокированы и недопустимы. |
|
Paid
|
paid | boolean |
Значение true, если плата выполнена успешно или была успешно авторизована для последующей записи. |
|
Электронная почта квитанции
|
receipt_email | string |
Это адрес электронной почты, в который была отправлена квитанция для этой оплаты. |
|
Номер квитанции
|
receipt_number | string |
Это номер транзакции, который отображается в квитанциях электронной почты, отправленных за эту плату. |
|
Возвращен
|
refunded | boolean |
Будет ли плата полностью возвращена. Если плата будет частично возвращена, этот атрибут по-прежнему будет ложным. |
|
Дескриптор инструкций
|
statement_descriptor | string |
Дополнительные сведения об оплате. Это будет отображаться в заявлении кредитной карты клиента. |
|
Состояние
|
status | string |
Состояние платежа выполнено успешно, ожидалось или завершилось сбоем. |
При добавлении элемента счета
Активирует новый поток при добавлении элемента счета.
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор
|
id | string |
Идентификатор элемента счета. |
|
Сумма
|
amount | integer |
Положительное целое число в наименьшей денежной единице, представляющее общую сумму для элемента счета. |
|
Валюта
|
currency | string |
3-буквенный ISO-код, представляющий валюту, в которой был сделан элемент счета. |
|
Клиент
|
customer | string |
Идентификатор клиента, используемый для элемента счета. |
|
Date
|
date | date-time |
Дата элемента счета. |
|
описание
|
description | string |
Описание элемента счета. |
|
Скидка
|
discountable | boolean |
Если задано значение true, скидки будут применяться к этому элементу счета. Всегда false для параметров пропорциональности. |
|
Invoice
|
invoice | string |
Идентификатор счета, в который был добавлен элемент счета. |
|
Пропорциональность
|
proration | boolean |
Независимо от того, был ли элемент счета создан автоматически в качестве корректировки пропорциональности, когда клиент переключил планы. |
|
Количество
|
quantity | integer |
Если элемент счета является пропорциональной, количество подписки, для которую вычислено пропорциональное значение. |
|
Subscription
|
subscription | string |
Подписка, для которую был создан этот элемент счета, если таковой имеется. |
Определения
Скидка
Описывает текущую скидку, активную для клиента, если она есть.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Клиент
|
customer | string |
Идентификатор клиента, связанного с этой скидкой. |
|
Конец
|
end | integer |
Если купон имеет длительность повторения, дата окончания этой скидки. |
|
Start
|
start | integer |
Дата применения купона. |
|
Subscription
|
subscription | string |
Подписка, к которую применяется этот купон, если она применяется к определенной подписке. |
|
coupon
|
coupon | Coupon |
Талон
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор
|
id | string |
Уникальный идентификатор объекта. |
|
Имя
|
name | string |
Имя купона, отображаемого клиентам на экземплярах счетов или квитанций. |
|
Продолжительность
|
duration | string |
Один из навсегда, один раз и повторяющийся. Описывает, сколько времени клиент, который применяет этот купон, получит скидку. |
|
Процент отключено
|
percent_off | float |
Процент, который будет снят с промежуточных итогов любых счетов для этого клиента в течение срока купона. |
|
Сумма отключена
|
amount_off | float |
Сумма (в указанной валюте), которая будет снята с промежуточных итогов любых счетов для этого клиента. |
Product_Response
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор
|
id | string |
Идентификатор продукта. |
|
Active
|
active | boolean |
Независимо от того, доступен ли продукт в настоящее время для покупки. |
|
Заголовок
|
caption | string |
Краткое однострочный описание продукта, которое должно отображаться клиенту. |
|
Создано
|
created | date-time |
дата создания продукта. |
|
Description
|
description | string |
Описание продукта, которое должно отображаться клиенту. |
|
Изображения
|
images | array of string |
Список до 8 URL-адресов изображений для этого продукта, предназначенный для отображения клиенту. |
|
Имя
|
name | string |
Имя продукта, которое должно отображаться клиенту. |
|
Поставляемые
|
shippable | boolean |
Подходит ли этот продукт. |
|
Updated
|
updated | date-time |
Дата обновления продукта. |
|
URL
|
url | string |
URL-адрес общедоступной веб-страницы для этого продукта. |
Customer_Response
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор
|
id | string |
Идентификатор клиента. |
|
Счете
|
account_balance | integer |
Текущий баланс, если он есть, хранится в учетной записи клиента. |
|
Создано
|
created | date-time |
Дата создания клиента. |
|
Валюта
|
currency | string |
Валюта, взимаемая клиентом, может взиматься в целях регулярного выставления счетов. |
|
Преступник
|
delinquent | boolean |
Не удалось ли выполнить последнюю плату за последний счет клиента. |
|
Description
|
description | string |
Описание клиента. |
|
Скидка
|
discount | Discount |
Описывает текущую скидку, активную для клиента, если она есть. |
|
Адрес электронной почты
|
string |
Сообщение электронной почты клиента. |