Mintcash
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 purpose on payments. It is card_verification on a card check and null on every payment that charges. A card check reads succeeded with amount: 0 and can't be refunded. Don't book it as a payment. See Card checks.
  • subscription.payment_method_updated is the only event for a card update on an active subscription. Its payment is the card check.
  • New optional field provider on the card-update request names the route the card is checked on.
  • At most 5 cards in any 24 hours may be submitted per active subscription. After that the endpoint returns 429.
  • The past_due hosted 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.

  • instrument has new values. Webhooks and GET /payments/{paymentId} report an APM payment with its method name, ideal, bancontact, blik, twint or revolut_bank, and card is null on it. Treat instrument as an open set.
  • methods on POST /payments picks what a payment's page may offer: card, wallets, apms or 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.
  • view and apmsLayout on 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 a view carry it.
  • New message mintcash:progress with stage started, 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_pay or ?view=google_pay. Pages that were set up as Apple Pay only before this release keep working unchanged. See Accept Apple Pay.
  • mintcash:wallet is posted by any wallet-only frame, once per wallet shown, not only by Apple Pay only pages.