Capture Payment Intent

//native

/**

 * Capture Payment Intent

 * Capture the funds of a PaymentIntent in `requires_capture` status. Leave `amount_to_capture` empty to capture the full amount; the remainder of a partial capture is released. Uncaptured intents are canceled after 7 days by default. `extra_params` passes any other documented field through as-is.

 */

export async function main(

  auth: RT.Stripe,

  payment_intent_id: string,

  amount_to_capture: number | undefined,

  metadata: { [key: string]: string } | undefined,

  extra_params: { [key: string]: any } | undefined

) {

  const response = await fetch(

    `https://api.stripe.com/v1/payment_intents/${payment_intent_id}/capture`,

    {

      method: "POST",

      headers: {

        Authorization: `Bearer ${auth.token}`,

        "Content-Type": "application/x-www-form-urlencoded",

        Accept: "application/json",

        "Stripe-Version": "2025-03-31.basil",

      },

      body: toForm({ amount_to_capture, metadata, ...extra_params }),

    }

  )

  if (!response.ok) {

    throw new Error(`${response.status} ${await response.text()}`)

  }

  return await response.json()

}

// Stripe takes form-encoded params with bracketed nesting: metadata[key]=v, items[0][price]=p

function toForm(

  params: { [key: string]: any },

  prefix = "",

  out = new URLSearchParams()

) {

  for (const [key, value] of Object.entries(params)) {

    if (value == null || value === "") continue

    const name = prefix ? `${prefix}[${key}]` : key

    if (typeof value === "object") toForm(value, name, out)

    else out.append(name, String(value))

  }

  return out

}