A member with a recurring subscription must authorise a payment card with Strong Customer Authentication (SCA) for the billing amount and frequency of their recurring subscription billing option.
The member's current recurring payment card is indicated by the isUsedForRecurringSubscriptionBilling property of their member payment cards.
A member with a recurring subscription may update their recurring payment card at any time. The updated recurring payment card will be billed for their next subscription billing period.
A member is eligible to change their recurring payment card when:
- They have a recurring subscription that's
ActiveorOnHoldand hasn't been cancelled, or - They have purchased a
futurerecurring subscription.
Members with a Frozen recurring subscription due to a billing error can update their recurring payment card and restore their subscription benefits by reactivating their subscription.
Authenticate the member and check that they are eligible to change their payment card.
Use the CreateRecurringSubscriptionEmbeddedPaymentCard endpoint to create a new recurring payment card for the member's subscription.
{
"webPaymentMethodId": 0,
"redirectReturnUrl": "http://example.com",
"languageTag": "string"
}This endpoint returns the details required to render an embedded payment UI for the member to authorise their payment card.
{
"memberPaymentCardId": "string",
"webPaymentMethodId": 0,
"connectorFunctionName": "string",
"connectorParametersJson": "string",
"createCardTokenUrl": "http://example.com",
"sdkScriptUrls": ["string"],
"isButtonIncluded": true,
"isPrimaryCardOptionIncluded": true,
"connectorScriptUrls": ["string"]
}For access to embedded payment UI reference code, talk to your local Vista representative.
If a member is using a third-party payment provider for recurring subscription billing, they may update their subscription to use Vista billing.
See switch to Vista recurring billing for more information.