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 o Stripe CLI, uma ferramenta essencial que dá acesso à linha de comando à sua integração da Stripe. Você também instala o SDK da Stripe para Java no lado do servidor para obter acesso às APIs da Stripe a partir de aplicativos programados em Java.

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 Maven ou Gradle
Como instalar o SDK para Java mais recente da Stripe v30.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 do Stripe para gerar um conjunto de chaves restritas. Para saber mais, consulte Chaves e permissões da CLI do Stripe.

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",

Gerenciar dependências de terceiros

Recomendamos gerenciar dependências de terceiros usando Maven ou Gradle, o que ajuda você a adicionar novas bibliotecas e incluí-las em seus projetos Java.

Inicialize um projeto

Para criar um projeto com o Maven, consulte Como faço para fazer meu primeiro projeto Maven?.
Para criar um projeto com o Gradle, consulte Exemplo de criação de aplicativos Java.

Instale o SDK para Java no lado do servidor

A versão mais recente do SDK da Stripe para Java no lado do servidor é v30.0.0. Ela aceita versões do Java acima de 1.8.

Verifique sua versão do Java :

Command Line

java -version

Instale a biblioteca

Com o Maven, insira o seguinte no arquivo pom.xml do seu projeto:

pom.xml
<dependency>
  <groupId>com.stripe</groupId>
  <artifactId>stripe-java</artifactId>
  <version>30.0.0</version>
</dependency>

Com o Gradle, cole a próxima linha dentro do bloco de dependências do seu arquivo build.gradle:

build.gradle

implementation 'com.stripe:stripe-java:30.0.0'

Alternativas de instalação

Instalação manual – Você pode instalar manualmente o stripe-java com os seguintes JARs: Baixar o Stripe JAR (.jar).

Baixe o Gson JAR (.jar) for Google Gson.

Proguard – Se estiver usando o ProGuard, exclua a biblioteca adicionando o seguinte ao arquivo proguard.cfg:

proguard.cfg

-keep class com.stripe.** { *; }

Executar sua primeira solicitação de SDK

Agora que você tem o SDK para Java 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.

Note

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.

CreatePrice.java
package com.stripe.sample;

import com.stripe.Stripe;
import com.stripe.exception.StripeException;
import com.stripe.model.Product;
import com.stripe.param.ProductCreateParams;
import com.stripe.param.PriceCreateParams;
import com.stripe.model.Price;

public class Server {
    public static void main(String[] args) throws StripeException {
        Stripe.apiKey = "sk_test_BQokikJOvBiI2HlWgH4olfQ2";


        ProductCreateParams productParams =
            ProductCreateParams.builder()
                .setName("Starter Subscription")
                .setDescription("$12/Month subscription")
                .build();
        Product product = Product.create(productParams);
        System.out.println("Success! Here is your starter subscription product id: " + product.getId());

        PriceCreateParams params =
            PriceCreateParams
                .builder()
                .setProduct(product.getId())
                .setCurrency("usd")
                .setUnitAmount(1200L)
                .setRecurring(
                    PriceCreateParams.Recurring
                        .builder()
                        .setInterval(PriceCreateParams.Recurring.Interval.MONTH)
                        .build())
                .build();
        Price price = Price.create(params);
        System.out.println("Success! Here is your starter subscription price id: " + price.getId());
    }
}

Salve o arquivo como CreatePrice.java. No projeto no seu IDE para Maven ou Gradle, execute a amostra. Por exemplo: Run 'CreatePrice.main()'.

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