Function getOrganizationPaymentMethod

packages/billing/src/auto-topup.ts:349–448

* Gets and selects the appropriate payment method for an organization. * Handles both card and link payment methods, with preference for existing default.

(params: {
  organizationId: string
  stripeCustomerId: string
  logger: Logger
})

 * Handles both card and link payment methods, with preference for existing default.
 */
async function getOrganizationPaymentMethod(params: {
  organizationId: string
  stripeCustomerId: string
  logger: Logger
}): Promise<string> {
  const { organizationId, stripeCustomerId, logger } = params
  const logContext = { organizationId, stripeCustomerId }

  // Get payment methods for the organization - include both card and link types
  const [cardPaymentMethods, linkPaymentMethods] = await Promise.all([
    stripeServer.paymentMethods.list({
      customer: stripeCustomerId,
      type: 'card',
    }),
    stripeServer.paymentMethods.list({
      customer: stripeCustomerId,
      type: 'link',
    }),
  ])

  const allPaymentMethods = [
    ...cardPaymentMethods.data,
    ...linkPaymentMethods.data,
  ]

  logger.debug(
    {
      ...logContext,
      cardPaymentMethodCount: cardPaymentMethods.data.length,
      linkPaymentMethodCount: linkPaymentMethods.data.length,
      totalPaymentMethodCount: allPaymentMethods.length,
      paymentMethodIds: allPaymentMethods.map((pm) => pm.id),
      paymentMethodTypes: allPaymentMethods.map((pm) => pm.type),
    },
    'Retrieved payment methods for organization (cards and link)',
  )

  if (allPaymentMethods.length === 0) {
    throw new AutoTopupPaymentError(
      'No payment methods available for organization',
    )
  }

  // Get the customer to check for default payment method
  const customer = await stripeServer.customers.retrieve(stripeCustomerId)

  let paymentMethodToUse: string | null = null

  // Check if there's already a default payment method
  if (
    customer &&
    !customer.deleted &&
    customer.invoice_settings?.default_payment_method
  ) {
    const defaultPaymentMethodId =
      typeof customer.invoice_settings.default_payment_method === 'string'
        ? customer.invoice_settings.default_payment_method
        : customer.invoice_settings.default_payment_method.id