Pagamentos e lojas

Para: pagamentos únicos e assinaturas, em uma página de checkout hospedada pela Stripe. Os compradores nunca digitam um número de cartão no seu app.

Conecta com: o botão Set up Stripe. Você preenche o formulário da própria Stripe e volta, e nenhuma chave é mostrada a você. Publique o app antes, porque a Stripe olha o site no ar e recusa um que ainda esteja em construção. Ela pede um documento de identidade e uma conta bancária. Você pode usar chaves no lugar: a chave publicável (começa com pk_) e a chave secreta (começa com sk_) das suas chaves de API da Stripe, e um segredo de assinatura do webhook (começa com whsec_).

Somente com chaves coladas: o cartão da Stripe mostra o endereço do webhook a adicionar na Stripe, com um botão de copiar. Adicione-o para os eventos checkout.session.completed e checkout.session.async_payment_succeeded. Com o botão, não há webhook para configurar.

Peça:

• “Adicione um botão Comprar agora para o curso”
• “Adicione um plano mensal e um botão Manage billing”
• “Adicione uma página Meus pedidos”

O que acontece: os pedidos são gravados quando a Stripe informa que um pagamento foi concluído, e aparecem em Manage, depois Payments. Veja Lojas online.

Limites: um app pode iniciar um checkout, lê-lo de volta e ler a sua lista de preços. Reembolsos, clientes e repasses não podem ser acessados por um app. Faça o reembolso em Manage, depois Payments, ou na Stripe. O botão Manage billing funciona apenas para uma pessoa conectada que tenha comprado algo nesse app.

Para: pagamentos e assinaturas em que a Paddle vende como a vendedora, então o IVA e o imposto sobre vendas são tratados por você. Vale a pena quando você vende entre países.

Conecta com: chaves, da página de autenticação da Paddle.

• Client-side Token (começa com live_, ou test_ para o sandbox). Público por definição, então é incorporado ao app publicado.
• API Key (começa com pdl_live_apikey_ ou pdl_test_apikey_). Fica nos servidores do Setherion.
• Webhook Secret (começa com pdl_ntfset_). Opcional.

Peça:

• “Adicione um plano Pro com um botão Assinar que abre o checkout da Paddle”
• “Mostre o preço e o que está incluído antes de o checkout abrir”

Como funciona: o checkout abre na própria sobreposição da Paddle, no navegador do visitante. Você cria os seus preços no painel da Paddle e o app os usa pelo id pri_ deles. A página nunca envia um valor, porque qualquer pessoa que abra a página pode editá-la.

Limites: a chave de API não é usada pelo app publicado, que não tem servidor. Um token que começa com test_ funciona apenas com o sandbox da Paddle. Test connection lê um produto da sua conta da Paddle.

Para: um botão de compra para um item a um preço fixo. O preço, o imposto e o frete ficam no PayPal, então ninguém que abra a página pode mudar o que paga. Os compradores pagam na própria janela do PayPal, com PayPal ou com cartão.

Conecta com: dois valores.

• Client ID: no PayPal, abra Pay links and buttons, depois um botão, depois o código dele. É o valor depois de client-id=. Público por definição.
• Moeda: três letras, como GBP ou EUR, a mesma dos seus botões no PayPal.

Crie seus botões antes, na página de botões do PayPal.

Peça:

• “Adicione um botão de compra do PayPal para cada uma das três gravuras”
• “Coloque o botão do PayPal embaixo do preço na página do produto”

Limites: cada botão compra um item ao preço definido no PayPal. Não há carrinho. O seu app não é avisado quando alguém paga: o PayPal envia um e-mail a você e ao comprador, e a venda não é registrada no app. Para um carrinho, pedidos guardados no seu app ou assinaturas, conecte a Stripe ou a Paddle. A página do conector diz o mesmo.

Para: cobrança de assinaturas. Um botão Assinar abre o checkout hospedado da Chargebee, um botão Manage billing abre o portal do cliente, e a sua equipe pode ver clientes, assinaturas e faturas.

Conecta com: chaves.

• Nome do site: a parte antes de .chargebee.com no endereço do seu painel, em minúsculas.
• Chave de API: na Chargebee, Settings, depois Configure Chargebee, depois API Keys, depois Add API Key. Escolha uma Write Key (criar, ler e atualizar, nunca excluir). É tudo de que um app precisa.

Peça:

• “Adicione uma página de preços a partir dos meus planos da Chargebee, com um botão Assinar em cada um”
• “Adicione um botão Manage billing para os clientes conectados”
• “Crie uma página da equipe com as minhas assinaturas e as faturas em aberto”

Quem pode fazer o quê: os visitantes podem iniciar um checkout, abrir o portal de cobrança e ler os planos e preços à venda, para uma página de preços. Clientes, assinaturas e faturas, e alterar planos e preços, são só para a sua equipe. Marque as contas que são da sua equipe em Manage, depois Cloud, depois Users.

Limites: ele usa o Product Catalog 2.0 da Chargebee, então os planos são item prices. Os valores chegam em centavos de libra ou de euro. Excluir não é possível a partir de um app. Em Permissions você pode desligar o checkout, o portal, ou a leitura e a alteração de clientes, assinaturas, faturas, planos e preços, um por um.

Para: uma nova vitrine sobre uma loja do Shopify. Produtos, preços e estoque ficam no Shopify, e os compradores pagam na própria página de checkout do Shopify.

Conecta com: dois valores.

• Domínio da loja: o endereço .myshopify.com, mesmo que a sua loja mostre um domínio personalizado aos clientes.
• Token da Storefront API (público): no admin do Shopify, abra Sales channels, depois Headless, depois Create storefront. Copie o token de acesso público dela.

Nunca use o token da Admin API (ele começa com shpat_): o cartão o recusa, porque este token é incorporado ao app publicado e qualquer pessoa pode lê-lo.

Peça:

• “Uma nova vitrine para a minha loja do Shopify, com as coleções na página inicial”
• “Adicione um carrinho que leve os compradores ao checkout do Shopify”
• “Adicione busca e filtros sobre os meus produtos do Shopify”

Permissões: o Shopify é diferente. Seus apps o chamam direto da página com o token público, então não há chaves no Setherion. Defina os limites no Shopify: Sales channels, Headless, a sua storefront, depois Manage ao lado de Storefront API, depois Permissions. Elas valem para todas as storefronts do canal Headless.

Limites: estoque, pedidos e pagamentos ficam no Shopify. Se um item estiver sem estoque, o app diz o que mudou antes de enviar o comprador adiante.

Para: uma vitrine que mostra os seus produtos reais do WooCommerce e envia os compradores ao seu próprio checkout.

Conecta com: chaves.

• Endereço da loja: o endereço em que a sua loja roda, aquele com /wp-admin depois dele.
• Consumer key (começa com ck_) e Consumer secret (começa com cs_): no WooCommerce, abra Settings, depois Advanced, depois REST API, depois Add key, com Permissions definido como Read.

As duas chaves ficam nos servidores do Setherion.

Peça:

• “Mostre os meus produtos do WooCommerce em uma grade, com um botão Comprar em cada um”
• “Adicione uma página para cada produto com as fotos e o preço”

Limites: produtos são a única coisa que um app pode ler. Pedidos e clientes são recusados, então não há histórico de pedidos nem conta de cliente aqui. A compra acontece na sua loja: o botão envia o comprador ao seu checkout com o produto adicionado. Os preços chegam na moeda da própria loja, como a loja os fornece. Test connection lê um produto.

Para: uma vitrine que mostra os seus produtos reais do PrestaShop e envia os compradores à página de cada produto na sua loja.

Conecta com: chaves.

• Endereço da loja: o endereço em que a sua loja roda, aquele com /admin depois dele.
• Chave de webservice: 32 letras e dígitos. No PrestaShop, abra Advanced Parameters, depois Web service, depois Add new webservice key, e marque View (GET) em products.

A chave fica nos servidores do Setherion.

Peça:

• “Mostre os meus produtos do PrestaShop com as fotos e os preços”
• “Ligue cada produto à página dele na minha loja”

Limites: produtos são a única coisa que um app pode ler. Pedidos e clientes são recusados, e as quantidades em estoque não estão disponíveis, então o app não mostra selos de “em estoque”. Os preços do PrestaShop não incluem imposto, e o app os rotula assim. Os compradores são enviados à página do produto na sua loja, não direto a uma cesta.