Configure seu ambiente de desenvolvimento
Início rápido por idioma
As bibliotecas auxiliares no lado do servidor (também conhecidas como SDKs no 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 e faça chamadas de API da Stripe sem escrever uma linha de código. 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.
Neste início rápido, você instala o Stripe CLI — uma ferramenta essencial que dá a você acesso à linha de comando à sua integração da Stripe. Você também instala o SDK da Stripe para Ruby no lado do servidor para obter acesso às APIs da Stripe a partir de aplicativos programados em Ruby.
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 um agrupador com RubyGems
- Como instalar o SDK da Stripe para Ruby v11.0.0
- Como enviar sua primeira solicitação de SDK
Configurar o Stripe CLI
Primeiro, crie uma conta Stripe ou entre.
Instalar
From the command-line, use an install script or download and extract a versioned archive file for your operating system to install the CLI.
Autenticar
Entre na sua conta de usuário Stripe e a autentique para gerar um conjunto de chaves restritas. Para saber mais, consulte Chaves e permissões da Stripe CLI.
stripe login
Pressione a tecla Enter no teclado para concluir o processo de autenticação no navegador.
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.
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":
, "object": "product","prod_LTenIrmp8Q67sa"
Em seguida, chame 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
).
stripe prices create \ --unit-amount=3000 \ --currency=usd \ --product=
{{PRODUCT_ID}}
Se tudo funcionar, a linha de comando exibirá a seguinte resposta.
{ "id":
, "object": "price","price_1KzlAMJJDeE9fu01WMJJr79o"
Gerenciar dependências de terceiros
Recomendamos gerenciar dependências de terceiros usando a ferramenta de linha de comando RubyGems, que permite adicionar novas bibliotecas e incluí-las em seus projetos Ruby. Verifique se o RubyGems está instalado:
Instalar RubyGems
gem --version
Se você receber gem: command not found
, baixe o RubyGems na página de downloads.
Instale o SDK para Ruby no lado do servidor
A versão mais recente do SDK da Stripe para Ruby no lado do servidor é v11.0.0. Ele aceita as versões do Ruby acima de 2.3.
Verifique sua versão Ruby:
ruby -v
Instale a biblioteca
Crie um arquivo gem e instale o gem gerado usando um agrupador com RubyGems.
Adicione a versão mais recente do Stripe gem a um projeto:
bundle add stripe
Instale os gems necessários de suas fontes especificadas:
bundle install
Alternativas de instalação
Execute sua primeira solicitação de SDK
Agora que você tem o SDK Ruby instalado, pode criar um Product de assinatura e vincular um Price com algumas solicitações de API. Estamos usando o identificador de produto retornado na resposta para criar o preço neste exemplo.
Observação
Este exemplo usa as chaves padrão da conta do seu usuário da Stripe para modo de teste. Só você pode ver esses valores.
require 'rubygems' require 'stripe' Stripe.api_key = "sk_test_4eC39HqLyjWDarjtT1zdp7dc" starter_subscription = Stripe::Product.create( name: 'Starter Subscription', description: '$12/Month subscription', ) starter_subscription_price = Stripe::Price.create( currency: 'usd', unit_amount: 1200, recurring: {interval: 'month'}, product: starter_subscription['id'], ) puts "Success! Here is your starter subscription product id: #{starter_subscription.id}" puts "Success! Here is your starter subscription price id: #{starter_subscription_price.id}"
Salve o arquivo como create_price.rb
. Na linha de comando, cd
para o diretório que contém o arquivo que você acabou de salvar e execute:
ruby create_price.rb
Se tudo funcionar, a linha de comando mostrará a seguinte resposta. Salve esses identificadores para usá-los durante a criação da integração.
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.