Pular para o conteúdo
Criar conta ou Entrar
O logotipo da documentação da Stripe
/
Criar contaLogin

Repassar dinheiro

Adicione fundos ao seu saldo da Stripe e faça repasses para vendedores ou prestadores de serviços.

Nota

A maioria das plataformas só pode fazer repasses de fundos para contas conectadas na mesma região e em moedas locais. Plataformas localizadas nos EUA podem fazer repasses internacionais para contas em outras regiões, sujeito a restrições.

Use este guia para saber como adicionar fundos ao saldo da sua conta e transferi-los para as contas bancárias dos usuários, sem processar pagamentos pela Stripe. Usamos como exemplo um produto de Perguntas e Respostas que paga aos seus autores uma parte da receita gerada por anúncios nas respostas. A plataforma e as contas conectadas estão nos EUA.

Nota

Somente membros da equipe com acesso de administrador à conta Stripe da plataforma e autenticação de dois fatores habilitada podem adicionar fundos.

Para empresas que usam pagamentos automáticos, os fundos adicionados ao saldo de pagamentos que excederem o saldo mínimo serão pagos no próximo repasse. Você pode configurar seu cronograma de repasses e as configurações de saldo mínimo nas Configurações de repasse.

Pré-requisitos

  1. Cadastre sua plataforma.
  2. Adicione dados da empresa para ativar sua conta.
  3. Conclua seu perfil da plataforma.
  4. Personalize as configurações da sua marca. Adicione um nome de empresa, ícone e cor da marca.

Configurar a Stripe
Lado do servidor

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

Command Line
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
# Available as a gem
sudo gem install stripe
Gemfile
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

Criar uma conta conectada

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.

Nota

Este guia usa contas conectadas que usam o Dashboard Express, que têm certas restrições. Como alternativa, você pode avaliar as contas Custom.

  • 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 a API /v1/accounts para criar uma conta conectada especificando as propriedades da conta conectada ou o tipo de conta.

    Command Line
    cURL
    Stripe CLI
    Ruby
    Python
    PHP
    Java
    Node.js
    Go
    .NET
    No results
    curl https://api.stripe.com/v1/accounts \
  -u "
    sk_test_BQokikJOvBiI2HlWgH4olfQ2
    :"     \
  -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 Account. Você pode preencher quaisquer dados de conta, inclusive dados pessoais e comerciais, dados de contas externas e muito mais.

    Depois de criar uma conta, crie uma Pessoa com relationship.representative definido como true para representar a pessoa responsável por abrir o conta e quaisquer informações da conta que você deseja preencher antecipadamente (por exemplo, seu nome e sobrenome).

    Command Line
    cURL
    Stripe CLI
    Ruby
    Python
    PHP
    Java
    Node.js
    Go
    .NET
    No results
    curl https://api.stripe.com/v1/accounts/
    {{ACCOUNT_ID}}
    /persons     \
  -u "
    sk_test_BQokikJOvBiI2HlWgH4olfQ2
    :"     \
  -d first_name=Jenny \
  -d last_name=Rosen \
  -d "relationship[representative]"=true

    O Connect Onboarding não solicita as informações pré-preenchidas. No entanto, ele solicita que o titular da conta confirme as informações pré-preenchidas antes de aceitar o contrato de serviços do Connect.

    Ao testar sua integração, preencha antecipadamente os dados da conta usando dados de teste.

    Criar um link da conta

    Você pode criar um link de conta chamando a API Account Links v1 com os seguintes parâmetros:

    • account
    • refresh_url
    • return_url
    • type = account_onboarding
    Command Line
    cURL
    Stripe CLI
    Ruby
    Python
    PHP
    Java
    Node.js
    Go
    .NET
    No results
    curl https://api.stripe.com/v1/account_links \
  -u "
    sk_test_BQokikJOvBiI2HlWgH4olfQ2
    :"     \
  -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

    Redirecionar o usuário ao URL do link da conta

    A resposta de criação de Account Link inclui um valor de URL. Depois de autenticar o usuário em sua inscrição, redirecione para esse URL para enviá-lo ao fluxo. Os URLs de link de conta da API Account Links v1 são temporários e de uso único, pois concedem acesso aos dados pessoais do usuário da conta conectada. Autentique o usuário em sua inscrição antes de redirecioná-lo para esse URL. Se quiser preencher previamente as informações, você deve fazer isso antes de gerar o link da conta. Depois de criar o link da conta, você não poderá ler ou gravar informações da conta conectada.

    Dica de segurança

    Não envie URLs de links de conta por e-mail, SMS ou outra maneira para fora do aplicativo da sua plataforma. Em vez disso, forneça-os ao titular da conta autenticado dentro do seu aplicativo.

    ConnectOnboardViewController.swift
    Swift
    Objective-C
    No results
    import UIKit
import SafariServices

let BackendAPIBaseURL: String = "" // Set to the URL of your backend server

class ConnectOnboardViewController: UIViewController {

    // ...

    override func viewDidLoad() {
        super.viewDidLoad()

        let connectWithStripeButton = UIButton(type: .system)
        connectWithStripeButton.setTitle("Connect with Stripe", for: .normal)
        connectWithStripeButton.addTarget(self, action: #selector(didSelectConnectWithStripe), for: .touchUpInside)
        view.addSubview(connectWithStripeButton)

        // ...
    }

    @objc
    func didSelectConnectWithStripe() {
        if let url = URL(string: BackendAPIBaseURL)?.appendingPathComponent("onboard-user") {
          var request = URLRequest(url: url)
          request.httpMethod = "POST"
          let task = URLSession.shared.dataTask(with: request) { (data, response, error) in
              guard let data = data,
                  let json = try? JSONSerialization.jsonObject(with: data, options: []) as? [String : Any],
                  let accountURLString = json["url"] as? String,
                  let accountURL = URL(string: accountURLString) else {
                      // handle error
              }

              let safariViewController = SFSafariViewController(url: accountURL)
              safariViewController.delegate = self

              DispatchQueue.main.async {
                  self.present(safariViewController, animated: true, completion: nil)
              }
          }
        }
    }

    // ...
}

extension ConnectOnboardViewController: SFSafariViewControllerDelegate {
    func safariViewControllerDidFinish(_ controller: SFSafariViewController) {
        // the user may have closed the SFSafariViewController instance before a redirect
        // occurred. Sync with your backend to confirm the correct state
    }
}

    Gerenciar o usuário que volta à 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.

    Nota

    Você pode usar HTTP para seu return_url e refresh_url enquanto estiver em um ambiente de teste (por exemplo, para testar com localhost), mas o modo de produção só aceita HTTPS. Certifique-se de trocar os URLs de teste por URLs HTTPS antes de lançar a produção.

    return_url

    A Stripe emite um redirecionamento para essa URL quando o usuário da conta conectada conclui o fluxo de onboarding. Isso não significa que todas as informações tenham sido recolhidas ou que não haja requisitos pendentes na conta. Significa apenas que o fluxo foi inserido e encerrado corretamente.

    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:

    • Ouça os Webhooks account.updated
    • Chame a API Accounts v1 e inspecione o objeto retornado

    refresh_url

    A Stripe redireciona seu usuário para o refresh_url nestes casos:

    • O link expirou (alguns minutos se passaram desde a criação do link).
    • O usuário já acessou o URL (atualizou a página ou clicou em Voltar ou Avançar no navegador).
    • Sua plataforma não consegue mais acessar a conta.
    • A conta foi recusada.

    Configure sua página refresh_url para acionar um método em seu servidor para chamar Account Links v1 novamente com os mesmos parâmetros e redirecionar o usuário para o novo link.

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

    Um usuário que é redirecionado para 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 se charges_enabled. Se a conta não estiver totalmente integrada, forneça prompts de IU para permitir que o usuário continue fazendo onboarding por meio de um novo link de conta. Você pode determinar se eles concluíram o onboarding verificando o estado do parâmetro details_submitted na conta deles.

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

    Depois de criar uma conta, crie uma Pessoa com relationship.representative definido como true para representar a pessoa responsável por abrir o conta e quaisquer informações da conta que você deseja preencher antecipadamente (por exemplo, seu nome e sobrenome).

    Command Line
    cURL
    Stripe CLI
    Ruby
    Python
    PHP
    Java
    Node.js
    Go
    .NET
    No results
    curl https://api.stripe.com/v1/accounts/
    {{ACCOUNT_ID}}
    /persons     \
  -u "
    sk_test_BQokikJOvBiI2HlWgH4olfQ2
    :"     \
  -d first_name=Jenny \
  -d last_name=Rosen \
  -d "relationship[representative]"=true

    O Connect Onboarding não solicita as informações pré-preenchidas. No entanto, ele solicita que o titular da conta confirme as informações pré-preenchidas antes de aceitar o contrato de serviços do Connect.

    Ao testar sua integração, preencha antecipadamente os dados da conta usando dados de teste.

  • Crie um link de conta

    • Crie um Link de conta com os seguintes argumentos:

    • account
    • refresh_url
    • return_url
    • type = account_onboarding
    Command Line
    cURL
    Stripe CLI
    Ruby
    Python
    PHP
    Java
    Node.js
    Go
    .NET
    No results
    curl https://api.stripe.com/v1/account_links \
  -u "
    sk_test_BQokikJOvBiI2HlWgH4olfQ2
    :"     \
  -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.

    Dica de segurança

    Não envie URLs de links de conta por e-mail, SMS ou outra maneira para fora do aplicativo da sua plataforma. Em vez disso, forneça-os ao titular da conta autenticado dentro do seu aplicativo.

  • 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.

    Nota

    Você pode usar HTTP para return_url e refresh_url enquanto estiver em um ambiente de teste (por exemplo, para testar com localhost), mas o modo de produção só aceita HTTPS. Não se esqueça de atualizar os URLs de teste para HTTPS antes de entrar em modo de produção.

    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.

    Adicionar fundos ao seu saldo

    Para adicionar fundos, acesse a seção Saldo no dashboard. Clique em Adicionar ao saldo e selecione um saldo para adicionar fundos.

    Selecione Saldo de pagamentos para adicionar fundos que são pagos às suas contas conectadas. Você também pode usar os fundos adicionados ao saldo de pagamentos para cobrir reembolsos e contestações futuras ou para quitar o saldo negativo da sua plataforma. Para saber mais sobre Saldo de reembolsos e contestações, consulte como adicionar fundos ao seu 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.

    Command Line
    cURL
    Stripe CLI
    Ruby
    Python
    PHP
    Java
    Node.js
    Go
    .NET
    No results
    curl https://api.stripe.com/v1/topups \
  -u "
    sk_test_BQokikJOvBiI2HlWgH4olfQ2
    :"     \
  -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.

    Repassar para seu usuário
    Lado do servidor

    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:

    Command Line
    curl
    Ruby
    Python
    PHP
    Java
    Node.js
    Go
    .NET
    No results
    curl https://api.stripe.com/v1/transfers \
  -u 
    sk_test_BQokikJOvBiI2HlWgH4olfQ2
    :     \
  -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.

    Testar sua integração

    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.

    Veja também

    Esta página foi útil?
    SimNão