aceite pagamentos usando cobranças e transferências separadas

Uma Checkout Session controla o que o seu cliente vê no formulário de pagamento, como itens de linha, o valor e a moeda do pedido, bem como formas de pagamento aceitáveis. Adicione um botão de checkout ao seu site para chamar um endpoint do lado do servidor e criar uma Sessão do Checkout.

No seu servidor, crie uma sessão do Checkout e redirecione o cliente para o URL retornado na resposta.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][product_data][name]"="Restaurant delivery service" \
  -d "line_items[0][price_data][unit_amount]"=10000 \
  -d "line_items[0][quantity]"=1 \
  -d "payment_intent_data[transfer_group]"=ORDER100 \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success?session_id={CHECKOUT_SESSION_ID}"

A Stripe envia um evento checkout.session.completed quando o pagamento é concluído. Use um webhook para receber esses eventos e executar ações, como enviar um e-mail de confirmação de pedido ao cliente, registrar a venda em um banco de dados ou iniciar um fluxo de entrega.

Ouça esses eventos em vez de esperar por um retorno de chamada do cliente. No cliente, o cliente poderia fechar a janela do navegador ou sair do aplicativo antes da execução do retorno de chamada. Algumas formas de pagamento também levam de 2 a 14 dias para a confirmação do pagamento. Configurar sua integração para ouvir eventos assíncronos permite que você aceite várias formas de pagamento com uma única integração.

Trate os seguintes eventos ao coletar pagamentos com o Checkout:

Todos esses eventos incluem o objeto Checkout Session. Após o pagamento, o status subjacente do PaymentIntent muda de processing para succeeded ou um status malsucedido.

No seu servidor, envie fundos da sua conta para uma conta conectada criando uma Transferência e especificando o transfer_group utilizado.

curl https://api.stripe.com/v1/transfers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=7000 \
  -d currency=usd \
  -d destination=
"{{CONNECTED_ACCOUNT_ID}}" \
  -d transfer_group=ORDER100

Os valores de transferência e cobrança não precisam ser iguais. Você pode dividir uma única cobrança entre várias transferências ou incluir várias cobranças em uma única transferência. O exemplo a seguir cria uma transferência adicional associada ao mesmo transfer_group.

curl https://api.stripe.com/v1/transfers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=2000 \
  -d currency=usd \
  -d destination={{OTHER_CONNECTED_ACCOUNT_ID}} \
  -d transfer_group=ORDER100

Opções de transferência

Você pode atribuir qualquer valor à string transfer_group, mas ela deve representar uma única ação de negócios. Também é possível fazer uma transferência sem associar uma cobrança ou transfer_group. Por exemplo, quando você paga um provedor, mas não há um pagamento a cliente associado.

Por padrão, uma solicitação de transferência falha quando o valor excede o saldo da conta disponível da plataforma. A Stripe não repete automaticamente solicitações de transferência malsucedidas.

Você pode evitar falhas nas solicitações de transferência para transferências associadas a cobranças. Quando você especifica a cobrança associada como a source_transaction da transferência, a solicitação de transferência é bem-sucedida automaticamente. No entanto, não executamos a transferência até que os fundos dessa cobrança estejam disponíveis na conta da plataforma.