Aggiorna Metodo di Pagamento
Aggiorna il metodo di pagamento per un abbonamento esistente. Puoi aggiungere un nuovo metodo di pagamento o utilizzare uno esistente dai metodi di pagamento salvati del cliente.
on_hold.
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
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 statoon_hold:
- Viene creato automaticamente un addebito per i due residui
- Viene generata una fattura per l’addebito
- Il pagamento viene elaborato con il nuovo metodo di pagamento
- Dopo il pagamento riuscito, l’abbonamento viene riattivato allo stato
active - Riceverai eventi webhook:
payment.succeededseguito dasubscription.active
Eventi Webhook
Quando aggiorni un metodo di pagamento per un abbonamentoon_hold, riceverai i seguenti eventi webhook:
payment.succeeded- L’addebito per i due residui è stato completato con successosubscription.active- L’abbonamento è stato riattivato
Autorizzazioni
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Parametri del percorso
Subscription Id
Corpo
new 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.
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, 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