Vai al contenuto principale
POST
/
subscriptions
/
{subscription_id}
/
update-payment-method
JavaScript
import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'], // This is the default and can be omitted
});

const response = await client.subscriptions.updatePaymentMethod('sub_Iuaq622bbmmfOGrVTqdXv', {
  payment_method: { type: 'new' },
});

console.log(response.payment_id);
{
  "client_secret": "<string>",
  "expires_on": "2023-11-07T05:31:56Z",
  "payment_id": "<string>",
  "payment_link": "<string>"
}
Aggiorna il metodo di pagamento per un abbonamento. Questo endpoint supporta sia abbonamenti attivi che abbonamenti nello stato on_hold.
Per gli abbonamenti in stato on_hold, l’aggiornamento del metodo di pagamento crea automaticamente un addebito per i due residui, genera una fattura e riattiva l’abbonamento allo stato active dopo il pagamento riuscito.

​
Casi d’Uso

  • Abbonamenti attivi: Aggiorna il metodo di pagamento quando una carta scade o il cliente desidera utilizzare un metodo di pagamento diverso
  • Abbonamenti in sospeso: Riattiva abbonamenti che sono stati messi in sospeso a causa di pagamenti non riusciti aggiornando il metodo di pagamento
  • Gestione dei metodi di pagamento: Passa tra i metodi di pagamento salvati o aggiungi nuovi metodi
Per elencare i metodi di pagamento esistenti per un cliente, utilizza le List Payment Methods API. Questo ti aiuta a recuperare gli ID dei metodi di pagamento disponibili quando usi type: "existing" per aggiornare il metodo di pagamento di un abbonamento.

​
Comportamento per Abbonamenti Attivi

Quando aggiorni il metodo di pagamento per un abbonamento attivo:
  • Il metodo di pagamento viene aggiornato immediatamente
  • Non viene creato alcun addebito
  • L’abbonamento rimane attivo
  • I rinnovi futuri utilizzeranno il nuovo metodo di pagamento

​
Comportamento per Abbonamenti in Sospeso

Quando aggiorni il metodo di pagamento per un abbonamento in stato on_hold:
  1. Viene creato automaticamente un addebito per i due residui
  2. Viene generata una fattura per l’addebito
  3. Il pagamento viene elaborato con il nuovo metodo di pagamento
  4. Dopo il pagamento riuscito, l’abbonamento viene riattivato allo stato active
  5. Riceverai eventi webhook: payment.succeeded seguito da subscription.active
Se il pagamento fallisce dopo l’aggiornamento del metodo di pagamento per un abbonamento on_hold, l’abbonamento rimarrà nello stato on_hold. Monitora gli eventi webhook per tracciare lo stato del pagamento.

​
Eventi Webhook

Quando aggiorni un metodo di pagamento per un abbonamento on_hold, riceverai i seguenti eventi webhook:
  1. payment.succeeded - L’addebito per i due residui è stato completato con successo
  2. subscription.active - L’abbonamento è stato riattivato

Autorizzazioni

​
Authorization
string
header
obbligatorio

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parametri del percorso

​
subscription_id
string
obbligatorio

Subscription Id

Corpo

application/json
​
type
enum<string>
obbligatorio
Opzioni disponibili:
new
​
allowed_payment_method_types
enum<string>[] | null

List of payment methods allowed during checkout.

Customers will never see payment methods that are not in this list. However, adding a method here does not guarantee customers will see it. Availability still depends on other factors (e.g., customer location, merchant settings).

All supported payment method types.

Used for disabled-payment-methods filtering and validation.

Opzioni disponibili:
ach,
affirm,
afterpay_clearpay,
alfamart,
ali_pay,
ali_pay_hk,
alma,
amazon_pay,
apple_pay,
atome,
bacs,
bancontact_card,
becs,
benefit,
bizum,
blik,
boleto,
bca_bank_transfer,
bni_va,
bri_va,
card_redirect,
cimb_va,
classic,
credit,
crypto_currency,
cashapp,
dana,
danamon_va,
debit,
duit_now,
efecty,
eft,
eps,
fps,
evoucher,
giropay,
givex,
google_pay,
go_pay,
gcash,
ideal,
interac,
indomaret,
klarna,
kakao_pay,
local_bank_redirect,
mandiri_va,
knet,
mb_way,
mobile_pay,
momo,
momo_atm,
multibanco,
online_banking_thailand,
online_banking_czech_republic,
online_banking_finland,
online_banking_fpx,
online_banking_poland,
online_banking_slovakia,
oxxo,
pago_efectivo,
permata_bank_transfer,
open_banking_uk,
pay_bright,
paypal,
paze,
pix,
pay_safe_card,
przelewy24,
prompt_pay,
pse,
red_compra,
red_pagos,
samsung_pay,
sepa,
sepa_bank_transfer,
sofort,
sunbit,
swish,
touch_n_go,
trustly,
twint,
upi_collect,
upi_intent,
vipps,
viet_qr,
venmo,
walley,
we_chat_pay,
seven_eleven,
lawson,
mini_stop,
family_mart,
seicomart,
pay_easy,
local_bank_transfer,
mifinity,
open_banking_pis,
direct_carrier_billing,
instant_bank_transfer,
billie,
zip,
revolut_pay,
naver_pay,
payco,
satispay
​
return_url
string | null

Risposta

Payment method updated

​
client_secret
string | null
​
expires_on
string<date-time> | null
​
payment_id
string | null
​
payment_link
string | null
Ultima modifica il 1 aprile 2026