---
title: "Loads and initiates the creation of a member payment card using an embedded UI for the currently authenticated member"
method: POST
path: "/ocapi/v1/members/current/payment-cards/embedded"
tags: ["Payments"]
---

# Loads and initiates the creation of a member payment card using an embedded UI for the currently authenticated member

`POST /ocapi/v1/members/current/payment-cards/embedded`

#### Licenses Required


- Vista.Ocapi

## Headers

- `loyaltySessionToken` string
- `Connect-Region-Code` string

## Request body

- OcapiV1LoyaltyMembersPaymentCardsRequestsEmbeddedMemberPaymentCardCreate — Represents the values needed to create an embedded member payment card for one-off order payments
  - `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

## Response `200`

Success

- OcapiV1LoyaltyMembersPaymentCardsEmbeddedMemberPaymentCardClientData — 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.
- `401` — No member authenticated.

---

[API](https://skmtc.net/vista/apis/vista-digital-platform.md) · [All operations](https://skmtc.net/vista/apis/vista-digital-platform/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vista/vista-digital-platform/revisions/3a81c0aed14e/schema)