Resources
Changelog
Changes to the API, the hosted payment page and the webhooks, newest first.
November 2026
Card update on active subscriptions
POST /subscriptions/{id}/card-update now works on an active subscription as well as a past_due one, enabled per account on request. The customer's bank checks the new card, nothing is charged, and renewals bill the new card from then on. See Update a card on a subscription.
- New field
purposeon payments. It iscard_verificationon a card check andnullon every payment that charges. A card check readssucceededwithamount: 0and can't be refunded. Don't book it as a payment. See Card checks. subscription.payment_method_updatedis the only event for a card update on anactivesubscription. Itspaymentis the card check.- New optional field
provideron the card-update request names the route the card is checked on. - At most 5 cards in any 24 hours may be submitted per
activesubscription. After that the endpoint returns429. - The
past_duehosted page now leads with the renewal that failed.
APMs on the hosted payment page
The page can offer alternative payment methods: iDEAL, Bancontact, BLIK, TWINT and Revolut Pay, enabled per account on request. The customer approves at their bank or app and comes back; you receive the usual payment.* webhooks. See Accept APMs.
instrumenthas new values. Webhooks andGET /payments/{paymentId}report an APM payment with its method name,ideal,bancontact,blik,twintorrevolut_bank, andcardisnullon it. Treatinstrumentas an open set.methodsonPOST /paymentspicks what a payment's page may offer:card,wallets,apmsor APMs by name. Omitted, it is["card", "wallets"], so existing integrations see no change. The response echoes the resolved list. See Choose what the checkout offers.viewandapmsLayouton the page URL narrow what one frame shows and lay APMs out as tiles or a list, so one payment can be split across several frames of your checkout. Messages from a frame opened with aviewcarry it.- New message
mintcash:progresswith stagestarted, posted when the customer commits to paying, before any 3DS challenge or bank page. - Wallet-only pages are now
methods: ["wallets"], narrowed with?view=apple_payor?view=google_pay. Pages that were set up as Apple Pay only before this release keep working unchanged. See Accept Apple Pay. mintcash:walletis posted by any wallet-only frame, once per wallet shown, not only by Apple Pay only pages.