Casos de uso para ampliar las respuestas
Consulta la comisión de Stripe de un determinado pago
En algunos casos, puede que quieras ver las comisiones de procesamiento asociadas con un pago. Las comisiones de Stripe solo se ven después que se haya procesado el pago; es decir, una vez que se efectúe el pago, las comisiones están disponibles en la transacción de saldo asociada al objeto Charge. En lugar de recuperar una transacción de saldo separada, puedes obtenerla en una sola llamada usando expand
. Por ejemplo:
Usuarios en la versión de API 2022-08-01 o anterior:
Nota
Consulta los cargos incluidos en una transferencia
Cada transferencia automática está asociada a cambios históricos en el saldo de tu cuenta de Stripe. La API registra estos cambios históricos como transacciones de saldo, que puedes recuperar usando Enumerar transacciones de saldo. De una lista de transacciones de saldo, puedes expandir la propiedad source para recopilar información sobre qué activó el cambio en el saldo de la cuenta (un cargo, un rembolso, una transferencia, etc.). Por ejemplo:
Nota
Solo puedes recuperar el historial de transacciones de saldo para transferencias automáticas. Si tienes habilitadas transferencias manuales, debes hacer el seguimiento del historial de transacciones por tu cuenta.
Si usas Connect con cargos indirectos, puedes recuperar la misma información en nombre de tus cuentas conectadas. Una de las diferencias es que los cargos indirectos implican una transferencia y un pago vinculado (en forma de un objeto Charge) para transferir fondos a una cuenta conectada. Por ello, al enumerar las transacciones de saldo agrupadas en las transferencias de tu cuenta conectada, la fuente de cada transacción de saldo se vincula al pago de la transferencia en lugar de al objeto Charge original. Para recuperar el objeto Charge original, debes expandir la transferencia vinculada del pago mediante la propiedad source_transfer, y desde ahí, expandir la propiedad source_transaction de la transferencia: