Third-party subscription payment providers

While migrating recurring subscriptions to Vista Loyalty, a third-party payment provider (e.g., direct debit) may be phased out gradually to retain subscribers.

Member subscription payment provider

To check if the authenticated member is using a third-party subscription payment provider, use the GetCurrentMember endpoint to load their subscriptions and refer to the isUsingThirdPartyPaymentProvider property.

Copy
Copied
{
  "member": {
    "id": "string",
    "hash": "string",
    "subscriptions": {
      "current": {
        "subscriptionId": 0,
        "status": "Active",
        "startsAt": "2019-08-24T14:15:22Z",
        "expiresAt": "2019-08-24T14:15:22Z",
        "billingDetails": {
          "isRecurring": true,
          "reactivationPrice": {
            "valueIncludingTax": 0.1,
            "valueExcludingTax": 0.1,
            "tax": 0.1
          },
          "isUsingThirdPartyPaymentProvider": true,
          "currentBillingPeriodStartsAt": "2019-08-24T14:15:22Z",
          "nextBillingPeriodStartsAt": "2019-08-24T14:15:22Z"
        }
      },
      "future": null
    }
  }
}
NOTE

Some properties have been omitted from the code snippet above for brevity.

Switch to Vista recurring billing

If a member is using a third-party payment provider for recurring subscription billing, they can update their subscription to use Vista billing at any time.

To switch to Vista billing, the member must authorise their payment card for recurring billing. This card will be stored as the member's subscription payment card and will be charged for the next subscription billing period.

Switch to Vista recurring billing flow

Member authentication
Add recurring payment card
Set Vista as subscription payment provider

Member authentication

Authenticate the member and confirm they are using a third-payment provider.

Add recurring payment card

Follow the update recurring payment card flow to add a subscription payment card for their current subscription.

Set Vista as subscription payment provider

Once the member has a suitable subscription payment card, use the SetVistaAsSubscriptionPaymentProvider endpoint to update their subscription to use Vista billing.