Pular para o conteúdo
Criar conta
ou
Entrar
O logotipo da documentação da Stripe
/
Pergunte à IA
Criar conta
Login
Comece já
Pagamentos
Automação de finanças
Plataformas e marketplaces
Gestão de valores
Ferramentas para desenvolvedores
Comece já
Pagamentos
Automação de finanças
Comece já
Pagamentos
Automação de finanças
Plataformas e marketplaces
Gestão de valores
Visão geral
Controle de versão
Changelog
Atualize sua versão da API
Faça upgrade da sua versão do SDK
Ferramentas para desenvolvedores
SDKs
API
    API v2
    Chaves de API
    Cabeçalho do Stripe-Context
    Changelog diário
    Limitações de fluxo
    Testes automáticos
    Metadados
    Expandir respostas
      Casos de uso
    Paginação
    Domínios e endereços IP
    Pesquisar
    Localização
    Tratamento de erros
    Códigos de erro
Testes
Workbench
Destinos de evento
Fluxos de trabalho
Stripe CLI
Stripe Shell
Dashboard de desenvolvedores
Kit de ferramentas para agentes
Desenvolver com LLMsStripe para Visual Studio CodeAlertas de integridade da StripeCarregamento de arquivos
Segurança e privacidade
Segurança
Privacidade
Extend Stripe
Stripe Apps
Stripe Connectors
Parceiros
Ecossistema de parceiros
Certificação de parceiro
Página inicialFerramentas para desenvolvedoresAPIExpanding responses

Casos de uso para expandir respostas

Saiba como o atributo expand ajuda a realizar tarefas comuns.

Copiar página

Veja a tarifa da Stripe para um determinado pagamento

Você pode conferir as tarifas de processamento de um pagamento após o processamento do pagamento e a criação da transação de saldo. A Stripe cria automaticamente essa transação de saldo no segundo plano. O evento charge.updated inclui uma referência à transação de saldo por meio da propriedade balance_transaction(por exemplo, txn_123), indicando que a transação de saldo foi criada e está pronta para uso.

Em vez de procurar a transação de saldo separadamente, você pode recuperá-la em uma única chamada usando expand. Por exemplo:

Command Line
curl
curl https://api.stripe.com/v1/payment_intents/pi_1Gpl8kLHughnNhxyIb1RvRTu \ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
\ -d "expand[]"="latest_charge.balance_transaction" \ -G

Usuários na versão 2022-08-01 da API ou mais antiga:

Command Line
curl
curl https://api.stripe.com/v1/payment_intents/pi_1Gpl8kLHughnNhxyIb1RvRTu \ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
\ -d "expand[]"="charges.data.balance_transaction" \ -G

Observação

Um Payment Intent deve ser capturado e ter status de succeeded para que as tarifas da Stripe estejam disponíveis.

Ver as cobranças incluídas em um repasse

Cada repasse automático é vinculado às alterações anteriores no saldo da sua conta Stripe. A API registra essas alterações anteriores como transações de saldo, que você pode recuperar utilizando Listar transações de saldo. Em uma lista de transações de saldo, você pode expandir a propriedade source para reunir informações sobre o que acionou a alteração no saldo da conta (cobrança, reembolso, transferência etc.). Por exemplo:

Command Line
curl
curl https://api.stripe.com/v1/balance_transactions \ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
\ -d payout=po_1Gl3ZLLHughnNhxyDrOia0vI \ -d type=charge \ -d "expand[]"="data.source" \ -G

Observação

Você só pode recuperar o histórico de transações de saldo em automatic payouts. Se tiver repasses manuais ativados, você precisa rastrear o histórico de transações sem usar esses recursos.

Saiba mais sobre a reconciliação de repasses.

Se estiver usando o Connect com cobranças de destino, é possível recuperar as mesmas informações em nome de suas contas conectadas. Uma diferença é que as cobranças de destino envolvem uma transferência e um pagamento vinculado (na forma de um objeto Cobrança) para mover os fundos para uma conta conectada. Por isso, quando listar as transações de saldo agrupadas nos repasses da sua conta conectada, a origem de cada transação de saldo é vinculada ao pagamento da transferência e não da cobrança de origem. Para recuperar a cobrança de origem, é preciso expandir a transferência vinculada de um pagamento por meio da propriedade source_transfer; e, daí, expandir a propriedade source_transaction da transferência:

Command Line
curl
curl https://api.stripe.com/v1/balance_transactions \ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
\ -d payout=po_1G7bnaD2wdkPsFGzdVOqU44u \ -d type=payment \ -d "expand[]"="data.source.source_transfer.source_transaction" \ -H "Stripe-Account: acct_1G7PaoD2wdkPsFGz" \ -G
Esta página foi útil?
SimNão
Precisa de ajuda? Fale com o suporte.
Participe do nosso programa de acesso antecipado.
Confira nosso changelog.
Dúvidas? Fale com a equipe de vendas.
LLM? Read llms.txt.
Powered by Markdoc