الانتقال إلى المحتوى الرئيسي
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('subscription_id', {
  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>"
}
قم بتحديث طريقة الدفع للاشتراك. يدعم هذا النقطة النهائية الاشتراكات النشطة والاشتراكات في on_hold الحالة.
بالنسبة للاشتراكات في حالة on_hold، يؤدي تحديث طريقة الدفع تلقائيًا إلى إنشاء رسوم للمستحقات المتبقية، وإنشاء فاتورة، وإعادة تنشيط الاشتراك إلى حالة active عند نجاح الدفع.

​
حالات الاستخدام

  • الاشتراكات النشطة: تحديث طريقة الدفع عندما تنتهي صلاحية بطاقة أو يرغب العميل في استخدام طريقة دفع مختلفة
  • الاشتراكات المعلقة: إعادة تنشيط الاشتراكات التي تم تعليقها بسبب فشل المدفوعات عن طريق تحديث طريقة الدفع
  • إدارة طرق الدفع: التبديل بين طرق الدفع المحفوظة أو إضافة طرق جديدة
لقائمة طرق الدفع الموجودة لعميل، استخدم واجهة برمجة تطبيقات قائمة طرق الدفع. يساعدك ذلك في استرداد معرفات طرق الدفع المتاحة عند استخدام type: "existing" لتحديث طريقة الدفع في اشتراك.

​
السلوك للاشتراكات النشطة

عند تحديث طريقة الدفع لاشتراك نشط:
  • يتم تحديث طريقة الدفع على الفور
  • لا يتم إنشاء رسوم
  • يبقى الاشتراك نشطًا
  • ستستخدم التجديدات المستقبلية طريقة الدفع الجديدة

​
السلوك للاشتراكات المعلقة

عند تحديث طريقة الدفع لاشتراك في حالة on_hold:
  1. يتم إنشاء رسوم تلقائيًا للمستحقات المتبقية
  2. يتم إنشاء فاتورة للرسوم
  3. تتم معالجة الدفع باستخدام طريقة الدفع الجديدة
  4. عند نجاح الدفع، يتم إعادة تنشيط الاشتراك إلى حالة active
  5. ستتلقى أحداث ويب هوك: payment.succeeded متبوعًا بـsubscription.active
إذا فشل الدفع بعد تحديث طريقة الدفع لاشتراك في حالة on_hold، سيبقى الاشتراك في حالة on_hold. راقب أحداث الويب هوك لتتبع حالة الدفع.

​
أحداث ويب هوك

عند تحديث طريقة الدفع لاشتراك في حالة on_hold، ستتلقى أحداث ويب هوك التالية:
  1. payment.succeeded - تم نجاح الرسوم للمستحقات المتبقية
  2. subscription.active - تم إعادة تنشيط الاشتراك

التفويضات

​
Authorization
string
header
مطلوب

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

معلمات المسار

​
subscription_id
string
مطلوب

Subscription Id

الجسم

application/json
​
type
enum<string>
مطلوب
الخيارات المتاحة:
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 (from Hyperswitch).

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,
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
​
return_url
string | null

الاستجابة

Payment method updated

​
client_secret
string | null
​
expires_on
string<date-time> | null
​
payment_id
string | null
​
payment_link
string | null
Last modified on April 1, 2026