Langsung ke konten utama
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>"
}
Perbarui metode pembayaran untuk langganan. Endpoint ini mendukung baik langganan aktif maupun langganan dalam kondisi on_hold.
Untuk langganan dalam status on_hold, memperbarui metode pembayaran secara otomatis membuat tagihan untuk tunggakan yang tersisa, menghasilkan faktur, dan mengaktifkan kembali langganan ke status active setelah pembayaran berhasil.

​
Kasus Penggunaan

  • Langganan aktif: Perbarui metode pembayaran ketika kartu kedaluwarsa atau pelanggan ingin menggunakan metode pembayaran yang berbeda
  • Langganan ditangguhkan: Mengaktifkan kembali langganan yang ditangguhkan karena pembayaran gagal dengan memperbarui metode pembayaran
  • Manajemen metode pembayaran: Beralih antara metode pembayaran yang disimpan atau menambahkan yang baru
Untuk menampilkan metode pembayaran yang tersedia untuk pelanggan, gunakan List Payment Methods API. Ini membantu Anda mengambil ID metode pembayaran yang tersedia saat menggunakan type: "existing" untuk memperbarui metode pembayaran langganan.

​
Perilaku untuk Langganan Aktif

Saat memperbarui metode pembayaran untuk langganan aktif:
  • Metode pembayaran diperbarui segera
  • Tidak ada biaya yang dibuat
  • Langganan tetap aktif
  • Pembaruan di masa depan akan menggunakan metode pembayaran baru

​
Perilaku untuk Langganan Ditangguhkan

Saat memperbarui metode pembayaran untuk langganan dalam status on_hold:
  1. Biaya secara otomatis dibuat untuk tunggakan yang tersisa
  2. Faktur dibuat untuk biaya tersebut
  3. Pembayaran diproses menggunakan metode pembayaran baru
  4. Setelah pembayaran berhasil, langganan diaktifkan kembali ke status active
  5. Anda akan menerima event webhook: payment.succeeded diikuti oleh subscription.active
Jika pembayaran gagal setelah memperbarui metode pembayaran untuk langganan on_hold, langganan akan tetap dalam status on_hold. Pantau event webhook untuk melacak status pembayaran.

​
Peristiwa Webhook

Saat memperbarui metode pembayaran untuk langganan on_hold, Anda akan menerima event webhook berikut:
  1. payment.succeeded - Biaya untuk tunggakan berhasil
  2. subscription.active - Langganan telah diaktifkan kembali

Otorisasi

​
Authorization
string
header
wajib

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

Parameter Path

​
subscription_id
string
wajib

Subscription Id

Body

application/json
​
type
enum<string>
wajib
Opsi yang tersedia:
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.

Opsi yang tersedia:
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

Respons

Payment method updated

​
client_secret
string | null
​
expires_on
string<date-time> | null
​
payment_id
string | null
​
payment_link
string | null
Terakhir diubah pada 1 April 2026