Casos de uso para ampliar las respuestas
Amplía las respuestas de la API para devolver datos de pagos comunes.
Usa el parámetro expand
en tu petición a la API para recuperar detalles que la API no devuelve en su respuesta predeterminada. Los siguientes casos de uso son ejemplos de la información más solicitada.
Consulta la comisión de Stripe de un determinado pago
Puedes consultar las comisiones de procesamiento de un pago después de que se procese el pago y Stripe cree la transacción de saldo. El evento charge.updated hace referencia a la propiedad balance_
(por ejemplo, txn_
), lo que indica que está listo para usar.
En lugar de buscar la transacción de saldo por separado, puedes recuperarla en una sola llamada usando expand
.
Nota
Los usuarios de IC+ no pueden recuperar la información de la comisión de pago de la transacción de saldo. En su lugar, usa el informe de comisiones de pago.
Usuarios en la versión de API 2022-08-01 o anterior:
Nota
Para que las comisiones de Stripe estén disponibles, debe capturarse un intento de pago cuyo estado sea succeeded
.
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 reembolso, 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.
Más información sobre la conciliación de transferencias.
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 un envío de fondos 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 del envío de fondos en lugar de al objeto Charge original. Para recuperar el objeto Charge original, debes expandir el envío de fondos vinculado del pago mediante la propiedad source_transfer, y desde ahí, expandir la propiedad source_transaction del envío de fondos: