Update a PaymentIntent

POST {{baseUrl}}/v1/payment_intents/:intent

Updates properties on a PaymentIntent object without confirming.

Depending on which properties you update, you may need to confirm the PaymentIntent again. For example, updating the payment_method will always require you to confirm the PaymentIntent again. If you prefer to update and confirm at the same time, we recommend updating properties via the confirm API instead.

Request Body

[{"name"=>"amount", "value"=>"<integer>", "datatype"=>"string"}, {"name"=>"capture_method", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"currency", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"customer", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"description", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"expand[0]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"expand[1]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_data[type]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_data[acss_debit][account_number]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_data[acss_debit][institution_number]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_data[acss_debit][transit_number]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_data[au_becs_debit][account_number]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_data[au_becs_debit][bsb_number]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_data[bacs_debit][account_number]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_data[bacs_debit][sort_code]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_data[billing_details][address][city]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_data[billing_details][address][country]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_data[billing_details][address][line1]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_data[billing_details][address][line2]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_data[billing_details][address][postal_code]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_data[billing_details][address][state]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_data[billing_details][email]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_data[billing_details][name]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_data[billing_details][phone]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_data[boleto][tax_id]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_data[eps][bank]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_data[fpx][bank]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_data[ideal][bank]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_data[klarna][dob][day]", "value"=>"<integer>", "datatype"=>"string"}, {"name"=>"payment_method_data[klarna][dob][month]", "value"=>"<integer>", "datatype"=>"string"}, {"name"=>"payment_method_data[klarna][dob][year]", "value"=>"<integer>", "datatype"=>"string"}, {"name"=>"payment_method_data[metadata]", "value"=>"<object>", "datatype"=>"string"}, {"name"=>"payment_method_data[p24][bank]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_data[radar_options][session]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_data[sepa_debit][iban]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_data[sofort][country]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_data[us_bank_account][account_holder_type]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_data[us_bank_account][account_number]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_data[us_bank_account][account_type]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_data[us_bank_account][financial_connections_account]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_data[us_bank_account][routing_number]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[acss_debit][mandate_options][custom_mandate_url]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[acss_debit][mandate_options][interval_description]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[acss_debit][mandate_options][payment_schedule]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[acss_debit][mandate_options][transaction_type]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[acss_debit][setup_future_usage]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[acss_debit][verification_method]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[affirm][capture_method]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[affirm][setup_future_usage]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[afterpay_clearpay][capture_method]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[afterpay_clearpay][reference]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[afterpay_clearpay][setup_future_usage]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[alipay][setup_future_usage]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[au_becs_debit][setup_future_usage]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[bacs_debit][setup_future_usage]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[bancontact][preferred_language]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[bancontact][setup_future_usage]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[blik][code]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[boleto][expires_after_days]", "value"=>"<integer>", "datatype"=>"string"}, {"name"=>"payment_method_options[boleto][setup_future_usage]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[card][capture_method]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[card][cvc_token]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[card][installments][enabled]", "value"=>"<boolean>", "datatype"=>"string"}, {"name"=>"payment_method_options[card][installments][plan][count]", "value"=>"<integer>", "datatype"=>"string"}, {"name"=>"payment_method_options[card][installments][plan][interval]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[card][installments][plan][type]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[card][mandate_options][amount]", "value"=>"<integer>", "datatype"=>"string"}, {"name"=>"payment_method_options[card][mandate_options][amount_type]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[card][mandate_options][interval]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[card][mandate_options][reference]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[card][mandate_options][start_date]", "value"=>"<unix-time>", "datatype"=>"string"}, {"name"=>"payment_method_options[card][mandate_options][description]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[card][mandate_options][end_date]", "value"=>"<unix-time>", "datatype"=>"string"}, {"name"=>"payment_method_options[card][mandate_options][interval_count]", "value"=>"<integer>", "datatype"=>"string"}, {"name"=>"payment_method_options[card][mandate_options][supported_types][0]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[card][mandate_options][supported_types][1]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[card][network]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[card][request_three_d_secure]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[card][setup_future_usage]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[card][statement_descriptor_suffix_kana]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[card][statement_descriptor_suffix_kanji]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[card_present][request_extended_authorization]", "value"=>"<boolean>", "datatype"=>"string"}, {"name"=>"payment_method_options[card_present][request_incremental_authorization_support]", "value"=>"<boolean>", "datatype"=>"string"}, {"name"=>"payment_method_options[customer_balance][bank_transfer][type]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[customer_balance][bank_transfer][eu_bank_transfer][country]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[customer_balance][bank_transfer][requested_address_types][0]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[customer_balance][bank_transfer][requested_address_types][1]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[customer_balance][funding_type]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[customer_balance][setup_future_usage]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[eps][setup_future_usage]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[fpx][setup_future_usage]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[giropay][setup_future_usage]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[grabpay][setup_future_usage]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[ideal][setup_future_usage]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[klarna][capture_method]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[klarna][preferred_locale]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[klarna][setup_future_usage]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[konbini][confirmation_number]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[konbini][expires_after_days]", "value"=>"<integer>", "datatype"=>"string"}, {"name"=>"payment_method_options[konbini][expires_at]", "value"=>"<unix-time>", "datatype"=>"string"}, {"name"=>"payment_method_options[konbini][product_description]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[konbini][setup_future_usage]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[link][capture_method]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[link][persistent_token]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[link][setup_future_usage]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[oxxo][expires_after_days]", "value"=>"<integer>", "datatype"=>"string"}, {"name"=>"payment_method_options[oxxo][setup_future_usage]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[p24][setup_future_usage]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[p24][tos_shown_and_accepted]", "value"=>"<boolean>", "datatype"=>"string"}, {"name"=>"payment_method_options[paynow][setup_future_usage]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[pix][expires_after_seconds]", "value"=>"<integer>", "datatype"=>"string"}, {"name"=>"payment_method_options[pix][expires_at]", "value"=>"<unix-time>", "datatype"=>"string"}, {"name"=>"payment_method_options[pix][setup_future_usage]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[promptpay][setup_future_usage]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[sepa_debit][setup_future_usage]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[sofort][preferred_language]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[sofort][setup_future_usage]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[us_bank_account][financial_connections][permissions][0]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[us_bank_account][financial_connections][permissions][1]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[us_bank_account][financial_connections][return_url]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[us_bank_account][networks][requested][0]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[us_bank_account][networks][requested][1]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[us_bank_account][setup_future_usage]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[us_bank_account][verification_method]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[wechat_pay][client]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[wechat_pay][app_id]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_options[wechat_pay][setup_future_usage]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_types[0]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_method_types[1]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"setup_future_usage", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"shipping[address][city]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"shipping[address][country]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"shipping[address][line1]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"shipping[address][line2]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"shipping[address][postal_code]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"shipping[address][state]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"shipping[name]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"shipping[carrier]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"shipping[phone]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"shipping[tracking_number]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"statement_descriptor", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"statement_descriptor_suffix", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"transfer_data[amount]", "value"=>"<integer>", "datatype"=>"string"}, {"name"=>"transfer_group", "value"=>"<string>", "datatype"=>"string"}]

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring