Listra
O Stripe permite que pessoas privadas e empresas aceitem pagamentos pela Internet. Você pode acompanhar clientes, pedidos, faturas e muito mais.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Microsoft |
| URL |
Suporte do Microsoft LogicApps Suporte do Microsoft Power Automate Suporte do Microsoft Power Apps |
| Metadados do conector | |
|---|---|
| Publicador | Microsoft |
| Site | https://stripe.com/ |
| Política de privacidade | https://stripe.com/privacy |
Problemas e limitações conhecidos
- Devido às limitações da API do Stripe , os gatilhos não podem processar mais de 100 eventos por segundo.
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Chave de API | secureString | Chave de API | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
| Frequência das pesquisas de gatilho | 1 | 120 segundos |
Ações
| Atualizar um cliente |
Atualiza o cliente especificado definindo os valores dos parâmetros passados. |
| Atualizar um produto |
Atualiza o produto específico definindo os valores dos parâmetros passados. |
| Criar um cliente |
Crie um novo cliente. |
| Criar um produto |
Cria um novo produto. |
| Obter um cliente |
Retorna os detalhes do cliente especificado. |
Atualizar um cliente
Atualiza o cliente especificado definindo os valores dos parâmetros passados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID
|
id | True | string |
A ID do cliente. |
|
Description
|
description | string |
Uma cadeia de caracteres arbitrária que você pode anexar a um cliente, isso não será definido se você enviar com um valor vazio. |
|
|
Email
|
string |
O endereço de email do cliente não será definido se você enviar com um valor vazio. |
Retornos
- Corpo
- Customer_Response
Atualizar um produto
Atualiza o produto específico definindo os valores dos parâmetros passados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID
|
id | True | string |
O identificador do produto. |
|
Nome
|
name | True | string |
O nome do produto, destinado a ser exibido para o cliente. |
|
Active
|
active | boolean |
Se o produto está ou não disponível para compra. O padrão é true. |
|
|
Legenda
|
caption | string |
Uma breve descrição de uma linha do produto, destinada a ser exibida para o cliente. |
|
|
Description
|
description | string |
A descrição do produto, destinada a ser exibida para o cliente. |
|
|
Imagens
|
images | string |
Uma lista de até 8 URLs de imagens para este produto, destinadas a serem exibidas para o cliente. |
|
|
Shippable
|
shippable | boolean |
Se este produto é enviado (ou seja, bens físicos). O padrão é true. |
|
|
URL
|
url | string |
Uma URL de uma página da Web acessível publicamente para este produto. |
Retornos
- Corpo
- Product_Response
Criar um cliente
Crie um novo cliente.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Description
|
description | string |
Uma cadeia de caracteres arbitrária que você pode anexar a um cliente, isso não será definido se você enviar com um valor vazio. |
|
|
Email
|
string |
O endereço de email do cliente não será definido se você enviar com um valor vazio. |
Retornos
- Corpo
- Customer_Response
Criar um produto
Cria um novo produto.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome
|
name | True | string |
O nome do produto, destinado a ser exibido para o cliente. |
|
ID
|
id | string |
O identificador do produto. Deve ser exclusivo. Se não for fornecido, um identificador será gerado aleatoriamente. |
|
|
Active
|
active | boolean |
Se o produto está ou não disponível para compra. O padrão é true. |
|
|
Legenda
|
caption | string |
Uma breve descrição de uma linha do produto, destinada a ser exibida para o cliente. |
|
|
Description
|
description | string |
A descrição do produto, destinada a ser exibida para o cliente. |
|
|
Imagens
|
images | string |
Uma lista de até 8 URLs de imagens para este produto, destinadas a serem exibidas para o cliente. |
|
|
Shippable
|
shippable | boolean |
Se este produto é enviado (ou seja, bens físicos). O padrão é true. |
|
|
URL
|
url | string |
Uma URL de uma página da Web acessível publicamente para este produto. |
Retornos
- Corpo
- Product_Response
Obter um cliente
Retorna os detalhes do cliente especificado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID
|
id | True | string |
A ID do cliente. |
Retornos
- Corpo
- Customer_Response
Gatilhos
| Quando um cliente é adicionado |
Dispara um novo fluxo quando um cliente é adicionado. |
| Quando um encargo é adicionado |
Dispara um novo fluxo quando uma carga é adicionada. |
| Quando um item de fatura é adicionado |
Dispara um novo fluxo quando um item de fatura é adicionado. |
| Quando um pedido é adicionado |
Dispara um novo fluxo quando uma ordem é adicionada. |
Quando um cliente é adicionado
Dispara um novo fluxo quando um cliente é adicionado.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
A ID do cliente. |
|
Saldo da conta
|
account_balance | integer |
O saldo atual, se houver, está sendo armazenado na conta do cliente. |
|
Criado
|
created | date-time |
O datetime em que o cliente foi criado. |
|
Moeda
|
currency | string |
A moeda em que o cliente pode ser cobrado para fins de cobrança recorrentes. |
|
Delinquente
|
delinquent | boolean |
Se a cobrança mais recente da fatura mais recente do cliente falhou ou não. |
|
Description
|
description | string |
A descrição do cliente. |
|
Desconto
|
discount | Discount |
Descreve o desconto atual ativo no cliente, se houver um. |
|
Email
|
string |
O email do cliente. |
Quando um encargo é adicionado
Dispara um novo fluxo quando uma carga é adicionada.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
A ID da cobrança. |
|
Quantidade
|
amount | integer |
Um inteiro positivo na menor unidade cambial (por exemplo, 100 centavos para cobrar US$ 1,00 ou 100 para cobrar <100, uma moeda decimal de 0) representando quanto cobrar. |
|
Valor Reembolsado
|
amount_refunded | integer |
Valor em centavos reembolsados (pode ser menor que o atributo de valor na cobrança se um reembolso parcial foi emitido). |
|
Capturado
|
captured | boolean |
Se a carga foi criada sem capturar, esse booliano representa se ele ainda não foi capturado ou não. |
|
Criado
|
created | date-time |
O datetime em que a cobrança foi criada. |
|
Moeda
|
currency | string |
Código de moeda ISO de três letras que representa a moeda na qual a cobrança foi feita. |
|
Customer
|
customer | string |
A ID do cliente para o qual esse encargo será cobrado se houver. |
|
Description
|
description | string |
A descrição da cobrança. |
|
Código de falha
|
failure_code | string |
Código de erro explicando o motivo da falha de cobrança, se disponível. |
|
Mensagem de falha
|
failure_message | string |
Mensagem para o usuário explicando ainda mais o motivo da falha de cobrança, se disponível. |
|
Invoice
|
invoice | string |
A ID da fatura para a qual essa cobrança será cobrada se houver. |
|
Pedido
|
order | string |
ID da ordem para a qual essa cobrança é para se existir. |
|
Status da rede
|
outcome.network_status | string |
Os valores possíveis são approved_by_network, declined_by_network, not_sent_to_network e reversed_after_approval. |
|
Reason
|
outcome.reason | string |
Um valor enumerado que indica uma explicação mais detalhada do tipo do resultado. |
|
Nível de risco
|
outcome.risk_level | string |
A avaliação da Stripe sobre o risco do pagamento. |
|
Mensagem do Vendedor
|
outcome.seller_message | string |
Uma descrição legível pelo ser humano do tipo de resultado e do motivo, projetada para o destinatário do pagamento. |
|
Tipo
|
outcome.type | string |
Os valores possíveis são autorizados, issuer_declined, bloqueados e inválidos. |
|
Paga
|
paid | boolean |
True se a cobrança foi bem-sucedida ou foi autorizada com êxito para captura posterior. |
|
Email de recebimento
|
receipt_email | string |
Este é o endereço de email para o qual o recibo desse encargo foi enviado. |
|
Número do recibo
|
receipt_number | string |
Esse é o número da transação que aparece em recibos de email enviados para esse encargo. |
|
Reembolsado
|
refunded | boolean |
Se a cobrança foi ou não totalmente reembolsada. Se a cobrança for apenas parcialmente reembolsada, esse atributo ainda será falso. |
|
Descritor de instrução
|
statement_descriptor | string |
Informações extras sobre uma cobrança. Isso será exibido na declaração de cartão de crédito do cliente. |
|
Situação
|
status | string |
O status do pagamento foi bem-sucedido, pendente ou falhou. |
Quando um item de fatura é adicionado
Dispara um novo fluxo quando um item de fatura é adicionado.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
A ID do item da fatura. |
|
Quantidade
|
amount | integer |
Um inteiro positivo na menor unidade de moeda que representa o valor total do item da fatura. |
|
Moeda
|
currency | string |
Código ISO de 3 letras que representa a moeda na qual o item da fatura foi feito. |
|
Customer
|
customer | string |
A ID do cliente usada para o item da fatura. |
|
Date
|
date | date-time |
A data do item da fatura. |
|
descrição
|
description | string |
A descrição do item da fatura. |
|
Com desconto
|
discountable | boolean |
Se for true, os descontos serão aplicados a este item de fatura. Sempre false para prorations. |
|
Invoice
|
invoice | string |
A ID da fatura à qual o item da fatura foi adicionado. |
|
Proration
|
proration | boolean |
Se o item da fatura foi ou não criado automaticamente como um ajuste de proration quando o cliente alternou os planos. |
|
Quantidade
|
quantity | integer |
Se o item da fatura for uma proração, a quantidade da assinatura para a qual a proração foi computada. |
|
Subscription
|
subscription | string |
A assinatura para a qual este item de fatura foi criado, se houver. |
Quando um pedido é adicionado
Dispara um novo fluxo quando uma ordem é adicionada.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
A ID da ordem. |
|
Quantidade
|
amount | integer |
Um inteiro positivo na menor unidade monetária. |
|
Valor Retornado
|
amount_returned | integer |
Valor em centavos reembolsados (pode ser menor que o atributo de valor na cobrança se um reembolso parcial foi emitido). |
|
Encargo
|
charge | string |
A ID do pagamento usado para pagar o pedido. Apresentar se o status do pedido for pago, atendido ou reembolsado. |
|
Criado
|
created | date-time |
O datetime em que a ordem foi criada. |
|
Moeda
|
currency | string |
Código ISO de 3 letras que representa a moeda na qual a ordem foi feita. |
|
Customer
|
customer | string |
O cliente usado para o pedido. |
|
Email
|
string |
O endereço de email do cliente que está fazendo o pedido. |
|
|
Método de envio selecionado
|
selected_shipping_method | string |
O método de envio atualmente selecionado para esse pedido, se houver. |
|
Situação
|
status | string |
Status do pedido atual. Um dos criados, pagos, cancelados, atendidos ou retornados. |
|
Atualizado
|
updated | date-time |
O datetime em que o pedido foi atualizado. |
Definições
Desconto
Descreve o desconto atual ativo no cliente, se houver um.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Customer
|
customer | string |
A ID do cliente associado a esse desconto. |
|
participante
|
end | integer |
Se o cupom tiver uma duração de repetição, a data em que esse desconto terminará. |
|
Start
|
start | integer |
Data em que o cupom foi aplicado. |
|
Subscription
|
subscription | string |
A assinatura à qual esse cupom é aplicado, se for aplicado a uma assinatura específica. |
|
cupom
|
coupon | Coupon |
Cupom
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
Identificador exclusivo para o objeto. |
|
Nome
|
name | string |
Nome do cupom exibido aos clientes em faturas ou recibos por exemplo. |
|
Duração
|
duration | string |
Um de sempre, uma vez, e repetindo. Descreve por quanto tempo um cliente que aplica esse cupom receberá o desconto. |
|
Porcentagem de desconto
|
percent_off | float |
Porcentagem que será retirada do subtotal de todas as faturas para esse cliente durante a duração do cupom. |
|
Valor desativado
|
amount_off | float |
Valor (na moeda especificada) que será retirado do subtotal de todas as faturas desse cliente. |
Product_Response
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
A ID do produto. |
|
Active
|
active | boolean |
Se o produto está ou não disponível para compra. |
|
Legenda
|
caption | string |
Uma breve descrição de uma linha do produto, destinada a ser exibida para o cliente. |
|
Criado
|
created | date-time |
o datetime em que o produto foi criado. |
|
Description
|
description | string |
A descrição do produto, destinada a ser exibida para o cliente. |
|
Imagens
|
images | array of string |
Uma lista de até 8 URLs de imagens para este produto, destinadas a serem exibidas para o cliente. |
|
Nome
|
name | string |
O nome do produto, destinado a ser exibido para o cliente. |
|
Shippable
|
shippable | boolean |
Se este produto é um bem enviado. |
|
Atualizado
|
updated | date-time |
O datetime em que o produto foi atualizado. |
|
URL
|
url | string |
Uma URL de uma página da Web acessível publicamente para este produto. |
Customer_Response
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
A ID do cliente. |
|
Saldo da conta
|
account_balance | integer |
O saldo atual, se houver, está sendo armazenado na conta do cliente. |
|
Criado
|
created | date-time |
O datetime em que o cliente foi criado. |
|
Moeda
|
currency | string |
A moeda em que o cliente pode ser cobrado para fins de cobrança recorrentes. |
|
Delinquente
|
delinquent | boolean |
Se a cobrança mais recente da fatura mais recente do cliente falhou ou não. |
|
Description
|
description | string |
A descrição do cliente. |
|
Desconto
|
discount | Discount |
Descreve o desconto atual ativo no cliente, se houver um. |
|
Email
|
string |
O email do cliente. |