Tokens

Create token

Saves a card and returns a reusable cardToken you can charge later with Pay with token. Send the raw card details once; Kashier stores them and hands back only the token and a masked card number, so your systems never have to keep the PAN. The request is validated with a Kashier-Hash header — an HMAC SHA256 hash of the path /?tokenization={merchantId}.{customerReference} generated from your backend with your secret. Use only those parameters in the hash creation; don't add extra parameters. The securityCode (CVV) you submit is exchanged for a single-use cvvToken; a stored token cannot be reused as a CVV on a later payment.

post/v3/cards/tokens

Request

  • Base URL: https://test-fep.kashier.io
  • URL: https://test-fep.kashier.io/v3/cards/tokens
  • Auth: none required

Headers

Kashier-Hashstring required

Order hash generated from your backend using the HMAC SHA256 crypto mechanism, as described in the Kashier hashing documentation.

Request body

merchantIdstring required

your merchant Id

customerReferencestring required

your customer Id — the reference that links your customer to the saved token. It must be the same value you use in the Kashier-Hash string.

Response

The card was tokenized successfully.

statusstring

Changes

No recorded changes to this operation across all 1 revision of this API.