---
title: "Register CVV for a card payment from checkout token"
method: POST
path: "/checkout/payment-methods/{card_id}/cvv"
tags: ["Checkout"]
---

# Register CVV for a card payment from checkout token

`POST /checkout/payment-methods/{card_id}/cvv`

## Request

- Base URL: `https://public-api.alternativepayments.io`
- URL: `https://public-api.alternativepayments.io/checkout/payment-methods/{card_id}/cvv`
- Auth: API key in header `Authorization`

Register an encrypted CVV token for a specific card. Uses customer_id and invoice_id from checkout token.

## Path parameters

- `card_id` string, required

## Request body

- CheckoutCreateCardCvvInput: CVV registration information
  - `cvv_secret` string
  - `provider` 'evervault'

## Response `201`

Created

- CheckoutCreateCardCvvResponse: Create card CVV response
  - `success` boolean

## Other responses

- `400`: Bad Request
- `422`: Unprocessable Entity

## Changes

- **2026-10-07** `4e3a31effa3f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/alternativepayments/apis/alternative-payments/changes/checkout/payment-methods/:card_id/cvv/post.md)

---

[API](https://skmtc.dev/alternativepayments/apis/alternative-payments.md) - [All operations](https://skmtc.dev/alternativepayments/apis/alternative-payments/llms.txt) - [OpenAPI document](https://skmtc.dev/alternativepayments/apis/alternative-payments/revisions/281251358a5b?raw)
