> ## Documentation Index > Fetch the complete documentation index at: https://www.marqeta.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Create digital wallet provisioning request for Samsung Wallet > Use the /digitalwalletprovisionrequests/samsungpay endpoint to return card data for use in provisioning a digital wallet token into Samsung Wallet. POST/digitalwalletprovisionrequests/samsungpay > [!NOTE] > > Use this endpoint if you use Marqeta only for tokenization as a service and are not a Marqeta card issuer. > If Marqeta is your card issuer, use the [Digital Wallets Management endpoint](https://www.marqeta.com/docs/core-api/digital-wallets-management/create-token-provisioning-request-samsung.md) instead. Use the `/digitalwalletprovisionrequests/samsungpay` endpoint to return card data for use in provisioning a digital wallet token into Samsung Wallet. The returned card data is encrypted using the digital wallet provider's encryption key, thereby reducing your Payment Card Industry (PCI) compliance overhead. ## Header parameter | Fields | Description | | - | - | | req-sys-id string Optional | Random pseudo-unique identifier of a request, used for troubleshooting between multiple parties. Usually a globally unique identifier (GUID). **Allowable Values:** 1–36 chars | ## Request body | Fields | Description | | - | - | | encrypted\_card\_data object Required | Encrypted data object. This object is first encrypted using the recipient's public key and sent in [JSON Web Encryption (JWE) format](https://openid.net/specs/draft-jones-json-web-encryption-02.html) and then signed using the sender's private key using [JSON Web Signature (JWS)](https://openid.net/specs/draft-jones-json-web-signature-04.html). It represents the decrypted format. **Allowable Values:** `card_token`, `card_type`, `cardholder_info`, `expiration`, `metadata`, `primary_account_number` | | encrypted\_card\_data.**expiration** object Required | Specifies the expiry date for the card. **Allowable Values:** `month`, `year` | | encrypted\_card\_data.expiration.**month** string Required | Specifies the expiry month for the card in MM format. `01`, for example. **Allowable Values:** Format: MM | | encrypted\_card\_data.expiration.**year** string Required | Specifies the expiry year for the card in yyyy format. `2024`, for example. **Allowable Values:** Format: yyyy | | encrypted\_card\_data.**card\_token** string Optional | Unique identifier of the card. **Allowable Values:** 1–36 chars | | encrypted\_card\_data.**primary\_account\_number** string Required | Account number of the card being tokenized. **Allowable Values:** 12–19 chars | | encrypted\_card\_data.**card\_type** string Optional | Specifies the type of card. This field is required for Samsung Wallet. **Allowable Values:** `CREDIT`, `DEBIT` | | encrypted\_card\_data.**cardholder\_info** object Optional | Contains personal information about the cardholder. **Allowable Values:** `cardholder_address`, `email_address`, `first_name`, `last_name`, `phone_number` | | encrypted\_card\_data.cardholder\_info.**first\_name** string Optional | First or given name of the cardholder. **Allowable Values:** 40 char max | | encrypted\_card\_data.cardholder\_info.**last\_name** string Optional | Last or family name of the cardholder. **Allowable Values:** 40 char max | | encrypted\_card\_data.cardholder\_info.**cardholder\_address** object Optional | Specifies the cardholder's address. **Allowable Values:** `address_line_1`, `address_line_2`, `city`, `country_code`, `postal_code`, `state` | | encrypted\_card\_data.cardholder\_info.cardholder\_address.**address\_line\_1** string Required | Street address of the cardholder. **Allowable Values:** 1–255 chars | | encrypted\_card\_data.cardholder\_info.cardholder\_address.**address\_line\_2** string Optional | Additional address information for the cardholder, such as a suite, floor, room, PO Box or apartment number. `Suite 600`, for example. **Allowable Values:** 255 char max | | encrypted\_card\_data.cardholder\_info.cardholder\_address.**postal\_code** string Required | Postal code of the cardholder. **Allowable Values:** 1–50 chars | | encrypted\_card\_data.cardholder\_info.cardholder\_address.**city** string Optional | City of the cardholder. **Allowable Values:** 40 char max | | encrypted\_card\_data.cardholder\_info.cardholder\_address.**state** string Optional | State or province code associated with the cardholder's address. **Allowable Values:** 3 char max | | encrypted\_card\_data.cardholder\_info.cardholder\_address.**country\_code** string Optional | Two-character [ISO 3166-1 alpha-2 country code](https://www.iso.org/iso-3166-country-codes.html). `US`, for example. **Allowable Values:** 2 char max | | encrypted\_card\_data.cardholder\_info.**email\_address** string Optional | Email address of the cardholder. **Allowable Values:** 255 char max | | encrypted\_card\_data.cardholder\_info.**phone\_number** string Optional | Phone number of the cardholder. This number is used when Marqeta performs step-up authentication on your behalf. **Allowable Values:** 255 char max | | encrypted\_card\_data.**metadata** array of objects Optional | Additional metadata related to the card details object. **Allowable Values:** Valid array of card details metadata objects | | encrypted\_card\_data.metadata\[].**name** string Required | Specifies the metadata attribute name, such as `CARD_ART_ID`, `MAX_TOKENS_PER_CARD`, and so on. **Allowable Values:** 255 char max | | encrypted\_card\_data.metadata\[].**value** string Required | Specifies the value of the metadata attribute. **Allowable Values:** 255 char max | | card\_token string Optional | Unique identifier of the card. **Allowable Values:** 1–36 chars | | device\_type string Optional | Specifies the type of device. **Allowable Values:** `APPLIANCE`, `GAMING_DEVICE`, `LAPTOP`, `MOBILE_PHONE`, `MOBILE_PHONE_OR_TABLET`, `PERSONAL_COMPUTER`, `TABLET`, `UNKNOWN`, `UNRECOGNIZED`, `VEHICLE`, `WATCH` | | provisioning\_app\_version string Optional | Specifies the version of the application making the provisioning request. This field is used for debugging and fraud prevention. **Allowable Values:** 50 char max | | wallet\_user\_id string Required | User's Samsung Wallet account identifier, as provided by Samsung during the provisioning process. **Allowable Values:** 1–50 chars | | device\_id string Required | User's Samsung device unique identifier, as provided by Samsung during the provisioning process. **Allowable Values:** 1–24 chars | ## Sample request body Sample Samsung Pay request ```json JSON expandable lines wrap theme={null} { "encrypted_card_data": { "expiration": { "month": "01", "year": "2025" }, "card_token": "card-token-811", "card_type": "CREDIT", "primary_account_number": "4111111111111111", "cardholder_info": { "first_name": "Jane", "last_name": "Liu", "cardholder_address": { "city": "Oakland", "state": "CA", "address_line_1": "180 Grand Ave", "address_line_2": "Floor 6", "postal_code": "94612", "country_code": "US" }, "email_address": "marqetaTest@marqeta.com", "phone_number": "1234567890" } }, "device_id": "W85OGhjZTk2dsr452dgsr51j", "wallet_user_id": "ae25OGhjZTk2dsr452dgsr51", "provisioning_app_version": "2.13.3" } ``` ## Response body | Fields | Description | | - | - | | created\_time datetime Returned | Date and time when the resource was created, in UTC. **Allowable Values:** date-time **Format:** yyyy-MM-ddThh:mm:ssZ | | last\_modified\_time datetime Returned | Date and time when the resource was created, in UTC. **Allowable Values:** date-time **Format:** yyyy-MM-ddThh:mm:ssZ | | card\_token string Conditionally returned | Unique identifier of the card. **Allowable Values:** 1–36 chars | | push\_tokenize\_request\_data object Returned | Contains data pertaining to a Samsung push tokenization request. **Allowable Values:** `card_type`, `display_name`, `extra_provision_payload`, `last_digits`, `network`, `token_service_provider` | | push\_tokenize\_request\_data.**display\_name** string Returned | Name of the card as displayed in the digital wallet, typically showing the card brand and last four digits of the primary account number (PAN). `Visa 5678`, for example. **Allowable Values:** 255 char max | | push\_tokenize\_request\_data.**last\_digits** string Returned | Last four digits of the funding primary account number (FPAN), which is the primary account number of the physical or virtual card. **Allowable Values:** 4 chars | | push\_tokenize\_request\_data.**network** string Returned | Card network, as defined by Google; expected to align with the value of the `token_service_provider` field. **Allowable Values:** `Visa`, `Mastercard` | | push\_tokenize\_request\_data.**token\_service\_provider** string Returned | Token service provider, as defined Google; expected to align with the value of the `network` field. **Allowable Values:** `MC`, `VI` | | push\_tokenize\_request\_data.**extra\_provision\_payload** string Returned | Encrypted card or cardholder details. **Allowable Values:** Encrypted string | | push\_tokenize\_request\_data.**card\_type** string Returned | Specifies the type of payment card. **Allowable Values:** `CREDIT`, `DEBIT`, `GIFT`, `LOYALTY`, `PAYMENT` | ## Sample response body Sample Samsung Pay response ```json JSON expandable lines wrap theme={null} { "created_time": "2025-09-09T18:08:05Z", "last_modified_time": "2025-09-09T18:08:05Z", "card_token": "my_card_01", "push_tokenize_request_data": { "display_name": "Mastercard Card", "last_digits": "6591", "network": "Mastercard", "token_service_provider": "MC", "extra_provision_payload": "ewogICJjYXJkSW5mbyIgOiB7CiAgICAicHVibGl....", "card_type": "PAYMENT" } } ``` ## Related topics - [Digital Wallet Provisioning Requests Overview](https://www.marqeta.com/docs/core-api/tokenization-as-a-service/provisioning-requests.md) - [Tokenization-as-a-Service Overview](https://www.marqeta.com/docs/core-api/tokenization-as-a-service.md) - [Create digital wallet token provisioning request for Samsung Wallet](https://www.marqeta.com/docs/core-api/digital-wallets-management/create-token-provisioning-request-samsung.md) - [Create digital wallet token provisioning request for XPay](https://www.marqeta.com/docs/core-api/digital-wallets-management/create-token-provisioning-request-xpay.md) - [Create digital wallet provisioning request for Google Wallet](https://www.marqeta.com/docs/core-api/tokenization-as-a-service/provisioning-requests/create-digital-wallet-provisioning-request-google-wallet.md)