Casos de uso para ampliar respuestas

Usa el parámetro expand en tu solicitud de API para recuperar detalles que la API no devuelve en su respuesta predeterminada. Los siguientes casos de uso ilustran esto para la información más solicitada.

Mira la comisión de Stripe de un determinado pago

Puedes consultar las comisiones de procesamiento de un pago después de que este se procese y Stripe cree la transacción de saldo. El evento charge.updated hace referencia a la propiedad balance_transaction (por ejemplo, txn_123), lo que indica que está lista para su uso.

En lugar de buscar la transacción de saldo por separado, puedes recuperarla en una sola llamada usando expand.

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

Usuarios en la versión de API 2022-08-01 o anterior:

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

Mira los cargos incluidos en una transferencia

Cada transferencia a cuenta bancaria 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 la opción Enumerar transacciones de saldo. En una lista de transacciones de saldo, puedes expandir la propiedad source para reunir información acerca de qué activó el cambio en el saldo de la cuenta (un cargo, un reembolso, una transferencia, etc.). Por ejemplo:

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

Más información sobre la conciliación de transferencias.

Si usas Connect con cargos a un Destino, puedes recuperar la misma información en nombre de tus cuentas conectadas. Una de las diferencias es que los cargos a un Destino 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 a cuenta bancaria 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:

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