Migração para o Payment Intents

Estas são as etapas de uma integração criada com Stripe.js e Elements:

1. Registrar sua intenção de coletar pagamentos no lado do servidor
2. Coletar dados de pagamento no lado do cliente
3. Iniciar a criação do pagamento
4. Executar o pedido do cliente no lado do servidor

Etapa 1: registrar sua intenção de coletar pagamentos no lado do servidor

Crie um PaymentIntent no seu servidor e deixe-o acessível no lado do cliente.

curl https://api.stripe.com/v1/payment_intents \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "amount"=1099 \
  -d "currency"="usd"

Etapa 2: coletar dados de pagamento no lado do cliente

Use a função confirmCardPayment, que coleta os dados de pagamento e os envia diretamente à Stripe.

stripe.createToken(
  cardElement
).then(function(token) {
  // Send token to server
});

stripe.confirmCardPayment(
  INTENT_SECRET_FROM_STEP_1,
  {
    payment_method: {card: cardElement}
  }
).then(function(result) {
  if (result.error) {
    // Display error.message in your UI.
  } else {
    // The payment has succeeded
    // Display a success message
  }
});

Etapa 3: iniciar a criação do pagamento

Na integração existente, a última etapa é usar dados de pagamento tokenizados para criar uma cobrança no seu servidor. Isso não é mais necessário, pois a função confirmCardPayment, chamada na etapa anterior, inicia a criação da cobrança.

curl https://api.stripe.com/v1/charges \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "source"="{{FROM_PREVIOUS_STEP}}" \
  -d "amount"=1099 \
  -d "currency"="usd"

Etapa 4: executar o pedido do cliente

Com a confirmação automática, a cobrança é criada para você de forma assíncrona a partir da ação do cliente, por isso, você deve monitorar os webhooks para determinar quando o pagamento é concluído corretamente. Para realizar etapas como processamento de pedido após o pagamento bem-sucedido de um cliente, implemente a compatibilidade com webhooks e monitore o evento payment_intent.succeeded.

Agora que você fez a migração, use os cartões de teste na seção a seguir para verificar se a sua integração atualizada gerencia autenticação 3D Secure.

Uma integração da API Payment Intents que coleta dados de cartão no fluxo de checkout consiste nas seguintes etapas:

1. Registrar sua intenção de coletar pagamentos no lado do servidor
2. Coletar dados de pagamento no lado do cliente
3. Iniciar a criação do pagamento
4. Executar o pedido do cliente no lado do servidor

Etapa 1: registrar sua intenção de coletar pagamentos no lado do servidor

Crie um PaymentIntent no seu servidor. Defina setup_future_usage como off_session se pretender cobrar os usuários quando estiverem fora do seu aplicativo ou on_session se planejar cobrá-los no aplicativo. Se planejar usar o cartão para pagamentos na sessão e fora dela, use off_session. Informar o parâmetro setup_future_usage junto com o ID do cliente salvará o PaymentMethod resultante para esse cliente após a confirmação do PaymentIntent e a conclusão de todas as ações necessárias pelo cliente. Em seguida, torne o PaymentIntent acessível no lado do cliente.

curl https://api.stripe.com/v1/payment_intents \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "setup_future_usage"="off_session" \
  -d "amount"=1099 \
  -d "currency"="usd"

Etapa 2: coletar dados de pagamento no lado do cliente

Use a função confirmCardPayment, que coleta os dados de pagamento e os envia diretamente à Stripe.

stripe.createToken(
// or stripe.createSource
  cardElement
).then(function(token) {
  // Send token to server
});

stripe.confirmCardPayment(
  '{{INTENT_SECRET_FROM_STEP_1}}',
  {
    payment_method: {card: cardElement},
  }
).then(function(result) {
  if (result.error) {
    // Display error.message in your UI.
  } else {
    // The payment has succeeded
    // Display a success message
  }
});

Por último, vincule a forma de pagamento (paymentIntent.payment_method) ao cliente.

curl https://api.stripe.com/v1/customers/{{CUSTOMER_ID}}/sources \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "source"="{{TOKEN_OR_SOURCE}}"

curl https://api.stripe.com/v1/payment_method/{{PAYMENT_METHOD_ID}}/attach \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "customer"="{{CUSTOMER_ID}}"

Etapa 3: iniciar a criação do pagamento

Na integração existente, a última etapa é usar dados de pagamento tokenizados para criar uma cobrança no seu servidor. Isso não é mais necessário, pois a função confirmCardPayment, chamada na etapa anterior, inicia a criação da cobrança.

curl https://api.stripe.com/v1/charges \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "source"="{{FROM_PREVIOUS_STEP}}" \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "amount"=1099 \
  -d "currency"="usd"

Etapa 4: executar o pedido do cliente

Com a confirmação automática, a cobrança é criada para você de forma assíncrona a partir da ação do cliente, por isso, você deve monitorar os webhooks para determinar quando o pagamento é concluído corretamente. Para realizar etapas como processamento de pedido após o pagamento bem-sucedido de um cliente, implemente a compatibilidade com webhooks e monitore o evento payment_intent.succeeded.

Agora que você fez a migração, use os cartões de teste na seção a seguir para verificar se a sua integração atualizada gerencia autenticação 3D Secure.