Payment intents

Finish Stripe 3-D Secure verification after a purchase asks for it.

subbly.paymentIntents.getPaymentIntent(paymentIntentId)

Gets a payment intent, including the client secret Stripe needs to run 3-D Secure. Call it when subbly.checkout.purchase rejects with code: 'payment_requires_action'; the rejection carries the ID to pass here. Needs an authenticated customer.

Method parameters

paymentIntentIdRequiredstring

ID of the payment intent. Read it from err.paymentIntentId on the purchase error.

ReturnsPromise<PaymentIntentResponse>

The payment intent.


Get the client secret
const { token } = await subbly.paymentIntents.getPaymentIntent(err.paymentIntentId)

const { paymentIntent } = await stripe.confirmCardPayment(token)

subbly.paymentIntents.confirm(paymentIntentId, externalPaymentId)

Tells Subbly that Stripe finished verifying the payment intent. Call subbly.checkout.purchase again afterwards to finish the order. Needs an authenticated customer.

Method parameters

paymentIntentIdRequiredstring

ID of the Subbly payment intent, from err.paymentIntentId.

externalPaymentIdRequiredstring

ID Stripe gave back: the paymentIntent.id from stripe.confirmCardPayment.

ReturnsPromise<PaymentIntentResponse>

The payment intent, with its new status.


Finish a 3-D Secure purchase
try {
  await subbly.checkout.purchase(subbly.cart.id)
} catch (err) {
  if (err.code !== 'payment_requires_action') throw err

  const { token } = await subbly.paymentIntents.getPaymentIntent(err.paymentIntentId)
  const { paymentIntent } = await stripe.confirmCardPayment(token)

  await subbly.paymentIntents.confirm(err.paymentIntentId, paymentIntent.id)
  await subbly.checkout.purchase(subbly.cart.id)
}

Last modified on September 15, 2026

Payment intents

Finish Stripe 3-D Secure verification after a purchase asks for it.

subbly.paymentIntents.getPaymentIntent(paymentIntentId)

Method parameters

paymentIntentIdRequiredstring

ID of the payment intent. Read it from err.paymentIntentId on the purchase error.

ReturnsPromise<PaymentIntentResponse>

The payment intent.


Get the client secret
const { token } = await subbly.paymentIntents.getPaymentIntent(err.paymentIntentId)

const { paymentIntent } = await stripe.confirmCardPayment(token)

subbly.paymentIntents.confirm(paymentIntentId, externalPaymentId)

Tells Subbly that Stripe finished verifying the payment intent. Call subbly.checkout.purchase again afterwards to finish the order. Needs an authenticated customer.

Method parameters

paymentIntentIdRequiredstring

ID of the Subbly payment intent, from err.paymentIntentId.

externalPaymentIdRequiredstring

ID Stripe gave back: the paymentIntent.id from stripe.confirmCardPayment.

ReturnsPromise<PaymentIntentResponse>

The payment intent, with its new status.


Finish a 3-D Secure purchase
try {
  await subbly.checkout.purchase(subbly.cart.id)
} catch (err) {
  if (err.code !== 'payment_requires_action') throw err

  const { token } = await subbly.paymentIntents.getPaymentIntent(err.paymentIntentId)
  const { paymentIntent } = await stripe.confirmCardPayment(token)

  await subbly.paymentIntents.confirm(err.paymentIntentId, paymentIntent.id)
  await subbly.checkout.purchase(subbly.cart.id)
}

Last modified on September 15, 2026