Verify and store a card token

POST 
/v1/tokenization/tokenize

Receives a BasisTheory token ID created client-side by the frontend SDK, verifies it against BasisTheory, and persists card metadata (last4, expiry) for future use including saved-card functionality for returning customers.

Returns the verified token ID that can subsequently be used with Coinflow for payment processing.

Request

Responses

200

Token verified successfully

400

Invalid or missing request parameters

401

Unauthorized. When returned from tokenization/checkout handlers this reflects an upstream credential or permission failure (for example BasisTheory), not a missing merchant API key on the request.

403

Forbidden (e.g. merchant account inactive)

404

Resource not found

429

Upstream rate limit exceeded. The response does not currently include a Retry-After header.

500

Internal server error

502

Upstream provider error (e.g. BasisTheory)