Repassar dinheiro

Instale as bibliotecas oficiais da Stripe para acessar a API no seu aplicativo:

# Available as a gem
sudo gem install stripe

# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

Quando um usuário (vendedor ou prestador de serviços) se cadastrar em sua plataforma, crie uma Conta de usuário (chamada de connected account) para aceitar pagamentos e enviar valores para a conta bancária dele. Contas conectadas representam seus usuários na API da Stripe e facilitam o registro das informações obrigatórias para que a Stripe confirme a identidade do usuário. Num produto de Perguntas e respostas que paga pelas respostas, a conta conectada representa o autor.

Personalize seu formulário de cadastro

Nas configurações da plataforma, altere a cor e os logotipos para personalizar a aparência do formulário de registro do Express, mostrado aos usuários que clicam no link do Connect.

Formulário de inscrição Express padrão

Configurações da marca

Crie uma conta conectada e preencha os dados

Use the /v1/accounts API to create a connected account by specifying the connected account properties, or by specifying the account type.

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "controller[losses][payments]"=application \
  -d "controller[fees][payer]"=application \
  -d "controller[stripe_dashboard][type]"=express

Se você já coletou dados de suas contas conectadas, pode usá-los para preencher o objeto da conta. Você pode preencher quaisquer dados de conta, incluindo dados pessoais e comerciais, dados de contas externas e muito mais.

Connect Onboarding doesn’t ask for the prefilled information. However, it does ask the account holder to confirm the prefilled information before accepting the Connect service agreement.

When testing your integration, prefill account information using test data.

Crie um link de conta

Crie um Link de conta com os seguintes argumentos:

• account
• refresh_url
• return_url
• type = account_onboarding

curl https://api.stripe.com/v1/account_links \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d account=
{{CONNECTED_ACCOUNT_ID}} \
  --data-urlencode refresh_url="https://example.com/reauth" \
  --data-urlencode return_url="https://example.com/return" \
  -d type=account_onboarding

Redirecione seu usuário para o link da conta

A resposta à sua solicitação de Links de conta inclui um valor para a chave url. Redirecione o usuário para esse link. URLs da API Account Links são temporários e podem ser usados somente uma vez porque concedem acesso aos dados pessoais do titular da conta. Autentique o usuário no seu aplicativo antes de redirecioná-lo para esse URL. Se quiser preencher as informações, faça-o antes de gerar o link da conta. Após criar o link da conta, não será possível ler ou escrever informações na conta conectada.

Gerencie o usuário que retorna à sua plataforma

O Connect Onboarding exige que você passe um return_url e refresh_url para gerenciar todos os casos em que o usuário é redirecionado à sua plataforma. É importante implementá-los corretamente para proporcionar a melhor experiência ao usuário.

return_url

A Stripe emite um redirecionamento para este URL quando o usuário conclui o fluxo do Connect Onboarding. Isso não significa que todas as informações foram coletadas ou que não há requisitos pendentes na conta. Significa somente que a entrada e saída do fluxo foram normais.

Nenhum estado é passado por este URL. Após o redirecionamento de um usuário para o return_url , verifique o estado do parâmetro details_submitted na conta dele realizando uma das seguintes ações:

• Escutar eventos account.updated.
• Chamar a API Accounts e inspecionar o objeto retornado.

refresh_url

Seu usuário é redirecionado para o refresh_url quando:

• O link expirou (alguns minutos se passaram desde a criação do link).
• O link já foi acessado (o usuário atualizou a página ou clicou em Voltar ou Avançar no navegador).
• O link foi compartilhado em um aplicativo de terceiros, como um cliente de mensagens que tenta acessar o URL para visualizá-lo. Muitos clientes acessam automaticamente links que fazem com que eles expirem.
• Sua plataforma não consegue mais acessar a conta.
• A conta foi recusada.

O refresh_url deve chamar a API Account Links no seu servidor com os mesmos parâmetros e redirecionar o usuário para o fluxo do Connect Onboarding para que a experiência funcione perfeitamente.

Gerenciar usuários que não concluíram o onboarding

Um usuário que é redirecionado para o seu return_url pode não ter concluído o processo de onboarding. Use o endpoint /v1/accounts para recuperar a conta do usuário e verificar charges_enabled. Se a conta não estiver totalmente integrada, forneça solicitações de IU para permitir que o usuário continue o onboarding mais tarde. O usuário pode concluir a ativação da conta por meio de um novo link de conta (gerado por sua integração). Verifique o estado do parâmetro details_submitted na conta dele para ver se o processo de onboarding foi concluído.

Para adicionar fundos, vá até a seção Saldo no Dashboard. Clique em Adicionar ao saldo e selecione o motivo para a adição de fundos à sua conta.

Selecione Fazer repasse para contas conectadas para adicionar fundos para repassar às contas conectadas. Se estiver adicionando fundos ao seu saldo para cobrir reembolsos e contestações, ou para pagar o saldo negativo da sua plataforma, selecione Cobrir saldos negativos e confira adicionar fundos ao saldo da Stripe.

Verificar sua conta bancária

Siga o processo de verificação no Dashboard na primeira tentativa de adicionar fundos de uma conta bancária não verificada. Se a sua conta bancária não for verificada, será preciso confirmar dois microdepósitos da Stripe, que devem aparecer em 1 ou 2 dias úteis. A descrição no extrato será ACCTVERIFY.

A Stripe notifica você no Dashboard e por e-mail quando os microdepósitos chegam à sua conta. Para concluir o processo de verificação, clique na notificação do Dashboard na seção Saldo, insira os valores dos dois microdepósitos e clique em Verificar conta.

Criar uma recarga

Depois da verificação, crie uma recarga para adicionar fundos ao saldo da sua conta.

curl https://api.stripe.com/v1/topups \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=2000 \
  -d currency=usd \
  -d description="Top-up for week of May 31" \
  -d statement_descriptor="Weekly top-up"

Quando você faz uma transferência, aparece uma descrição da transação no seu extrato bancário. A descrição padrão é Recarga (Top-up). É possível personalizar a descrição do extrato e a descrição interna da recarga.

Ver fundos

Visualize seus fundos no Dashboard na guia Recargas na página Saldo. Cada vez que adiciona fundos, um objeto top-up é feito e tem um ID único no formato tu_XXXXXX, que pode ser visto na exibição detalhada da recarga.

Cronograma de liquidação de fundos

As plataformas dos EUA adicionam fundos por débito ACH, com prazo de 5 a 6 dias para disponibilização no seu saldo da Stripe. Você pode solicitar que sua conta seja considerada para um cronograma de liquidação mais rápido entrando em contato com o Suporte da Stripe.

Conforme a Stripe passa a conhecer melhor sua conta, pode reduzir automaticamente o prazo de liquidação.

Para adicionar fundos para futuros reembolsos e contestações ou cobrir um saldo negativo, você pode usar transferências bancárias, que disponibilizam os fundos em até 2 dias úteis.

Para transferir fundos disponíveis a uma conta conectada, você pode usar a API. Para transferir 10 USD para uma conta, faça a seguinte chamada:

curl https://api.stripe.com/v1/transfers \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d amount=1000 \
  -d currency="usd" \
  -d destination="{{CONNECTED_STRIPE_ACCOUNT_ID}}"

Por padrão, todos os fundos transferidos para uma conta conectada são acumulados no saldo da conta conectada da Stripe e repassados diariamente. É possível alterar o cronograma de repasses conforme for necessário.

No Dashboard da conta, é possível ver uma conta e seu saldo.

Use os tokens bancários de teste para simular fluxos para contas e onboarding, repasses e adição de fundos.