Skip to main content
TokenEx is a utility connector that creates a TokenEx token from card details collected via Gr4vy Secure Fields. It provides a secure way to produce a PSP-agnostic token without raw card data reaching your servers. This connector does not process payments. It is a tool to enable tokenization with TokenEx independently of a payment transaction.

How it works

Card details are collected via Gr4vy Secure Fields and passed directly to TokenEx for tokenization. The connector returns the resulting token without charging the card. The TokenEx connector:
  • Reduces PCI scope - Card details are collected via Gr4vy Secure Fields, so raw card data never reaches your servers.
  • Simplifies TokenEx integration - Produce a TokenEx token that can be used in server-side calls to any compatible payment processor.
  • Enables flexible workflows - Tokenize cards independently of the payment step, supporting deferred or external payment flows.

Setup

A TokenEx account can be requested by contacting the TokenEx sales team via their website.

Credentials

When setting up TokenEx in the dashboard, configure the following credentials, which are obtained via the TokenEx dashboard.
  • TokenEx ID - The unique identifier for your TokenEx account.
  • API Key - The API key used to authenticate with the TokenEx API.

Usage

  1. Add the TokenEx connector in the Gr4vy dashboard and enter your TokenEx ID and API key.
  2. Use Gr4vy Secure Fields to collect card details from the buyer. To store the card in Gr4vy at the same time, see Secure Fields with stored cards.
  3. Submit the card details to Gr4vy. The connector sends them to TokenEx and returns a token. To create or delete a PSP token for an already-stored payment method, use the provision PSP token and delete PSP token APIs.
  4. Use the token in your own server-side calls to a compatible payment processor.

Features

TokenEx supports the following features:
  • Create token - Create a TokenEx token from card details collected via Secure Fields.
  • Verify credentials - Validate the configured credentials against the TokenEx API.

Limitations

This connector only supports PSP tokenization. It cannot process payments, perform refunds, or carry out any other transaction-related operations.