Configure seu ambiente de desenvolvimento

Conheça o Stripe CLI e nossos SDKs no lado do servidor.

Os SDKs do lado do servidor e a interface de linha de comando (CLI) da Stripe permitem que você interaja com as APIs REST da Stripe. Comece com a Stripe CLI para simplificar seu ambiente de desenvolvimento e fazer chamadas de API.

Use os SDKs para não precisar programar rotinas padrão. Para começar a enviar solicitações do seu ambiente, escolha um idioma para seguir um guia de início rápido.

Extensões do Chrome

Recomendamos criar sua integração de pagamentos com a Stripe (como Elements ou Checkout) no seu próprio site. Em seguida, configure sua extensão do Chrome para enviar os usuários a esta página de pagamento quando estiverem prontos para concluir uma compra.

Esse método é mais seguro e fácil de manter do que tentar gerenciar pagamentos diretamente dentro da extensão.

Neste início rápido, você instala a Stripe CLI – uma ferramenta essencial que dá a você acesso por linha de comando à integração da Stripe. Você também instala o SDK da Stripe para Node.js no lado do servidor para obter acesso às APIs da Stripe a partir de aplicativos programados em Node.js.

O que você aprende

Neste início rápido, você aprenderá:

Como chamar as APIs da Stripe sem escrever uma linha de código
Como gerenciar dependências de terceiros usando o gerenciador de pacotes npm ou yarn
Como instalar o SDK da Stripe mais recente para Node v18.0.0
Como enviar sua primeira solicitação de SDK

Configuração inicial

Primeiro, crie uma conta Stripe ou entre.

Configurar o Stripe CLI

Instalar

Na linha de comando, use um script de instalação ou baixe e extraia um arquivo com controle de versão para que o sistema operacional instale a CLI.

Para instalar a Stripe CLI com homebrew, execute:

Command Line
brew install stripe/stripe-cli/stripe

Este comando falha se você executá-lo na versão Linux do homebrew, mas você pode usar essa alternativa ou seguir as instruções na guia Linux.

Command Line
brew install stripe-cli

Autenticar

Faça login e autentique sua conta de usuário da Stripe para gerar um conjunto de chaves restritas. Para saber mais, consulte Permissões e chaves da Stripe CLI.

Command Line

stripe login

Pressione a tecla Enter no teclado para concluir o processo de autenticação no navegador.

Output
Your pairing code is: enjoy-enough-outwit-win
This pairing code verifies your authentication with Stripe.
Press Enter to open the browser or visit https://dashboard.stripe.com/stripecli/confirm_auth?t=THQdJfL3x12udFkNorJL8OF1iFlN8Az1 (^C to quit)

Confirmar configuração

Agora que você instalou a CLI, pode fazer uma única solicitação de API para Criar um produto.

Command Line
stripe products create \
--name="My First Product" \
--description="Created with the Stripe CLI"

Procure o identificador do produto (em id) no objeto de resposta. Salve para a próxima etapa.

Se tudo funcionar, a linha de comando exibirá a seguinte resposta.

{
  "id": "prod_LTenIrmp8Q67sa"
,
  "object": "product",

Em seguida, invoque Criar um preço para anexar um preço de 30 USD. Substitua o espaço reservado em product com seu identificador de produto (por exemplo, prod_LTenIrmp8Q67sa).

Command Line
stripe prices create \
  --unit-amount=3000 \
  --currency=usd \
  --product={{PRODUCT_ID}}

Se tudo funcionar, a linha de comando exibirá a seguinte resposta.

{
  "id": "price_1KzlAMJJDeE9fu01WMJJr79o"
,
  "object": "price",

Instale o SDK para Node.js no lado do servidor

A versão mais recente do SDK da Stripe para Node no lado do servidor é v18.0.0. Ele aceita as versões do Node.js acima de 12.

Verifique sua versão do Node:

Command Line

node --version

Inicialize o Node

Command Line

npm init

Instale a biblioteca

Instale a biblioteca com npm, um gerenciador de pacotes para Node:

Command Line
npm install stripe --save

Depois de instalar a biblioteca com npm, ela é adicionada automaticamente como uma dependência no arquivo package.json do seu projeto. Por exemplo:

package.json
{
  "name": "stripe-node-example",
  "version": "1.0.0",
  "description": "A Stripe demo",
  "main": "index.js",
  "scripts": {
    "node ": "node create_price.js",
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "",
  "license": "ISC",
  "dependencies": {
    "stripe": "^18.0.0"
  }
}

Alternativas de instalação

Executar sua primeira solicitação de SDK

Agora que você tem o SDK para Node.js instalado, pode criar um Product de assinatura e vincular um Price com algumas solicitações de API. O SDK para Node.js retorna promessas que podem ser usadas como retornos de chamada encadeáveis. Para demonstrar, estamos passando o identificador do produto retornado na resposta do produto para criar um preço neste exemplo.

Observação

Este exemplo usa as chaves padrão de sua conta de usuário Stripe para seu ambiente de área restrita. Só você pode ver esses valores.

create_price.js
const stripe = require('stripe')('sk_test_BQokikJOvBiI2HlWgH4olfQ2');

stripe.products.create({
  name: 'Starter Subscription',
  description: '$12/Month subscription',
}).then(product => {
  stripe.prices.create({
    unit_amount: 1200,
    currency: 'usd',
    recurring: {
      interval: 'month',
    },
    product: product.id,
  }).then(price => {
    console.log('Success! Here is your starter subscription product id: ' + product.id);
    console.log('Success! Here is your starter subscription price id: ' + price.id);
  });
});

Salve o arquivo como create_price.js. Na linha de comando, cd para o diretório que contém o arquivo que você acabou de salvar e execute:

Command Line

node create_price.js

Se tudo funcionar, a linha de comando mostrará a seguinte resposta. Salve esses identificadores para usá-los durante a criação da integração.

Command Line
Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6
Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb

Veja também

Isso conclui o início rápido. Veja nos links abaixo algumas maneiras diferentes de processar um pagamento para o produto que você acabou de criar.