Casos de uso para expandir respostas
Veja a tarifa da Stripe para um determinado pagamento
Em alguns casos, você pode querer ver as tarifas de processamento associadas a um pagamento. Você só pode ver as tarifas da Stripe após o processamento de um pagamento. Após a conclusão de um pagamento, as tarifas estão disponíveis na transação de saldo da cobrança associada. Em vez de recuperar uma transação de saldo separadamente, é possível recuperá-la em uma única chamada usando expand
, por exemplo:
Usuários na versão 2022-08-01 da API ou mais antiga:
Observação
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:
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.
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: