Sign in
hostedFields

Create Hosted Fields session

Use this method to create a Hosted Fields session token. You need to generate a new session token each time you load Hosted Fields on a webpage.

In your request, you need to indicate whether the merchant is using Hosted Fields to run a sale, save payment details, or update saved payment details.

In the response, our gateway returns the session token and the time that it expires. You need the session token when you configure the JavaScript for Hosted Fields.

For more information about adding Hosted Fields to a webpage, go to Hosted Fields.

post/processing-terminals/{processingTerminalId}/hosted-fields-sessions

Path parameters

processingTerminalIdstring required

Unique identifier that we assigned to the terminal.

Headers

Authorizationstring required

Bearer authentication

Idempotency-Keystring uuid required

Unique identifier that you generate for each request. You must use the UUID v4 format for the identifier. For more information about the idempotency key, go to Idempotency.

Request body

libVersionstring required

Version of the Hosted Fields JavaScript library that you are using.

The current production version is 1.7.0.261471.

scenario'payment' | 'tokenization' required

Indicates if a merchant wants to take a payment or tokenize a customer's payment details:

  • payment - The merchant wants to run a sale or run a sale and tokenize in the same transaction.
  • tokenization - The merchant wants to save the customer's payment details to take a payment later or to update a customer's payment details that they've already saved.
secureTokenIdstring

Unique identifier that represents a customer's payment details.

If a merchant wants to update a customer's payment details that are linked to a secure token, include the secureTokenId in your request.

Response

Successful request. We created the session and returned a session token.

processingTerminalIdstring required

Unique identifier that we assigned to the terminal.

tokenstring required

Token that our gateway assigned to the Hosted Fields session.

Include this session token in the config file for Hosted Fields.

The session token expires after 10 minutes.

expiresAtstring date-time required

Date and time that the token expires. We return this value in the ISO 8601 format.

Changes