---
title: "Initiates creation of a future recurring member subscription and also loads and initiates the creation or selection of a member payment card using an embedded UI for the future recurring member subscription"
method: POST
path: "/ocapi/v1/members/current/subscriptions/future-recurring/payment-card/embedded"
tags: ["Subscriptions"]
---

# Initiates creation of a future recurring member subscription and also loads and initiates the creation or selection of a member payment card using an embedded UI for the future recurring member subscription

`POST /ocapi/v1/members/current/subscriptions/future-recurring/payment-card/embedded`

## Request

- Base URL: `https://developer.vista.co` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.vista.co/ocapi/v1/members/current/subscriptions/future-recurring/payment-card/embedded`
- Auth: none declared
- TypeScript: <https://skmtc.dev/vista/apis/vista-digital-platform/docs/ocapi/v1/members/current/subscriptions/future-recurring/payment-card/embedded/post.ts> (a function with typed inputs; its response is checked against the schema)

Upon creating or selecting the member payment card, the member's recurring
member subscriptions Future will be set.




The GetFutureRecurringSubscriptionCreation endpoint should be polled to determine the status of the future
recurring subscription.




Sets Vista as the payment provider for the member subscription, if not already set to Vista.

#### Licenses Required


- Vista.Ocapi
- Vista.Subscriptions

## Headers

- `Connect-Region-Code` string

## Request body

- OcapiV1LoyaltyMembersSubscriptionsRequestsFutureRecurringMemberSubscriptionEmbeddedPaymentCardCreate: Represents the values needed to create or select the member payment card used for a future recurring member subscription
  - `webPaymentMethodId` integer, required: Gets the unique identifier of the web payment method
  - `redirectReturnUrl` string, uri, nullable: Gets the URL that the browser will be directed to after the embedded payment has finished, if the requested web payment method requires redirect
  - `languageTag` string, nullable: Gets the IETF (RFC 4646) language tag
  - `subscriptionBillingOptionId` string, required: Gets the unique identifier of the subscription billing option that will be regularly charged to the created or selected member payment card

## Response `200`

Success

- OcapiV1LoyaltyMembersPaymentCardsMemberEmbeddedPaymentCardClientData: Represents the details required to initialise the embedded payment UI for adding a member payment card
  - `memberPaymentCardId` string, required: Gets the unique identifier of the member payment card
  - `webPaymentMethodId` integer, required: Gets the unique identifier of the web payment method
  - `connectorFunctionName` string, required: Gets the name of the connector function that needs to be called
  - `connectorParametersJson` string, required: Gets the JSON blob of parameters required by the connector
  - `createCardTokenUrl` string, uri, required: Gets the create card token URL
  - `sdkScriptUrls` string[], required: Gets the list of SDK script URLs that need to be loaded
  - `isButtonIncluded` boolean, required: Gets a value indicating whether the payment connector UI includes a submit button
  - `isPrimaryCardOptionIncluded` boolean, required: Gets a value indicating whether the primary card option is included
  - `connectorScriptUrls` string[], required: Gets the list of connector script URLs that need to be loaded

## Other responses

- `400`: Request property is invalid or missing, or member cannot set a future subscription.
- `401`: No member authenticated.

---

[API](https://skmtc.dev/vista/apis/vista-digital-platform.md) - [All operations](https://skmtc.dev/vista/apis/vista-digital-platform/llms.txt) - [OpenAPI document](https://skmtc.dev/vista/apis/vista-digital-platform/revisions/c46f30854000?raw)