Mettre à jour le mode de paiement
Mettez à jour le mode de paiement pour un abonnement existant. Vous pouvez soit ajouter un nouveau mode de paiement, soit utiliser un mode de paiement existant parmi les modes de paiement enregistrés du client.
on_hold.
on_hold, la mise à jour du mode de paiement crée automatiquement une charge pour les sommes restantes, génère une facture et réactive l’abonnement à l’état active après paiement réussi.Cas d’utilisation
- Abonnements actifs : Mettez à jour le mode de paiement lorsque la carte expire ou que le client souhaite utiliser un mode de paiement différent
- Abonnements en attente : Réactivez les abonnements qui ont été mis en attente en raison de paiements échoués en mettant à jour le mode de paiement
- Gestion des modes de paiement : Alternez entre les modes de paiement enregistrés ou ajoutez-en de nouveaux
type: "existing" pour mettre à jour le mode de paiement d’un abonnement.Comportement pour les abonnements actifs
Lors de la mise à jour du mode de paiement pour un abonnement actif :- Le mode de paiement est mis à jour immédiatement
- Aucun prélèvement n’est créé
- L’abonnement reste actif
- Les renouvellements futurs utiliseront le nouveau mode de paiement
Comportement pour les abonnements en attente
Lors de la mise à jour d’un mode de paiement pour un abonnement en étaton_hold :
- Une charge est automatiquement créée pour les sommes restantes
- Une facture est générée pour la charge
- Le paiement est traité avec le nouveau mode de paiement
- Après paiement réussi, l’abonnement est réactivé à l’état
active - Vous recevrez les événements webhook :
payment.succeededsuivie desubscription.active
Événements Webhook
Lors de la mise à jour d’un mode de paiement pour un abonnementon_hold, vous recevrez les événements webhook suivants :
payment.succeeded- La charge pour les sommes restantes a été effectuée avec succèssubscription.active- L’abonnement a été réactivé
Autorisations
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.
Corps
- 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