---
title: "Initialize a Secure Fields tokenization"
method: POST
path: "/v1/transactions/secureFields/tokenize"
tags: ["/v1/transactions"]
---

# Initialize a Secure Fields tokenization

`POST /v1/transactions/secureFields/tokenize`

## Request body

- TokenizeSecureFieldsInitRequest
  - `cardholder` CardholderData
    - `ipAddress` string — IP address.
    - `phoneNumber` string — Phone number.
    - `emailAddress` string — Email address.
  - `usage` 'SIMPLE' | 'REGISTRATION'
  - `applePay` ApplePaySettings
    - `merchantName` string — The canonical name for your store, suitable for display.
    - `currency` string, required — 3 letter <a href='https://en.wikipedia.org/wiki/ISO_4217' target='_blank'>ISO-4217</a> character code. For example `CHF` or `USD`
    - `country` string, required — 2 letter <a href='https://en.wikipedia.org/wiki/ISO_3166' target='_blank'>ISO 3166-1</a> alpha-2 character code. For example 'CH' or 'GR'
    - `amount` integer — The amount of the transaction in the currency’s smallest unit. For example use 1000 for CHF 10.00.
  - `googlePay` GooglePaySettings
    - `currency` string, required — 3 letter <a href='https://en.wikipedia.org/wiki/ISO_4217' target='_blank'>ISO-4217</a> character code. For example `CHF` or `USD`
    - `country` string — 2 letter <a href='https://en.wikipedia.org/wiki/ISO_3166' target='_blank'>ISO 3166-1</a> alpha-2 character code. For example 'CH' or 'GR'
    - `amount` integer — The amount of the transaction in the currency’s smallest unit. For example use 1000 for CHF 10.00.
    - `allowedAuthMethods` string[]

## Response `201`

Tokenization successfully initialized.

- SecureFieldsInitResponse
  - `transactionId` string — The `transactionId` to be used when calling SecureFields.init(). If no further action happens with the `transactionId` after initialization, it will be invalidated after 30 minutes.

## Other responses

- `400` — Bad request. Something went wrong.

---

[API](https://skmtc.net/pci-proxy/apis/pci-proxy-api-reference-datatrans-endpoints.md) · [All operations](https://skmtc.net/pci-proxy/apis/pci-proxy-api-reference-datatrans-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pci-proxy/pci-proxy-api-reference-datatrans-endpoints/versions/1f4f905fd175/schema)