تحديث طريقة الدفع
تحديث طريقة الدفع لاشتراك موجود. يمكنك إما إضافة طريقة دفع جديدة أو استخدام واحدة موجودة من طرق الدفع المحفوظة للعميل.
on_hold الحالة.
on_hold، يؤدي تحديث طريقة الدفع تلقائيًا إلى إنشاء رسوم للمستحقات المتبقية، وإنشاء فاتورة، وإعادة تنشيط الاشتراك إلى حالة active عند نجاح الدفع.حالات الاستخدام
- الاشتراكات النشطة: تحديث طريقة الدفع عندما تنتهي صلاحية بطاقة أو يرغب العميل في استخدام طريقة دفع مختلفة
- الاشتراكات المعلقة: إعادة تنشيط الاشتراكات التي تم تعليقها بسبب فشل المدفوعات عن طريق تحديث طريقة الدفع
- إدارة طرق الدفع: التبديل بين طرق الدفع المحفوظة أو إضافة طرق جديدة
type: "existing" لتحديث طريقة الدفع في اشتراك.السلوك للاشتراكات النشطة
عند تحديث طريقة الدفع لاشتراك نشط:- يتم تحديث طريقة الدفع على الفور
- لا يتم إنشاء رسوم
- يبقى الاشتراك نشطًا
- ستستخدم التجديدات المستقبلية طريقة الدفع الجديدة
السلوك للاشتراكات المعلقة
عند تحديث طريقة الدفع لاشتراك في حالةon_hold:
- يتم إنشاء رسوم تلقائيًا للمستحقات المتبقية
- يتم إنشاء فاتورة للرسوم
- تتم معالجة الدفع باستخدام طريقة الدفع الجديدة
- عند نجاح الدفع، يتم إعادة تنشيط الاشتراك إلى حالة
active - ستتلقى أحداث ويب هوك:
payment.succeededمتبوعًا بـsubscription.active
أحداث ويب هوك
عند تحديث طريقة الدفع لاشتراك في حالةon_hold، ستتلقى أحداث ويب هوك التالية:
payment.succeeded- تم نجاح الرسوم للمستحقات المتبقيةsubscription.active- تم إعادة تنشيط الاشتراك
التفويضات
Send your API key as a bearer token: Authorization: Bearer <api_key>. A test mode key starts with dodo_test_, for example dodo_test_AbCd1234EfGh5678.<secret>. A live mode key starts with dodo_live_. Use a test mode key on test.dodopayments.com and a live mode key on live.dodopayments.com. Keys from before these tags have no tag and operate as before.
الجسم
- New
- Existing
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