Skip to content

Store card verification code for card

Request

Request to store the card verification code (CVC) for a card associated with a gateway token.

Path
ownerIdstring, [ 0 .. 20 ] charactersrequired

The identifier of the vault owner. This must match the owner type. For example, provide your merchant group ID when ownerType is MerchantGroup.

Example:MERCHANT-GROUP-1
ownerTypestringrequired

The type of entity that owns the token vault. Use with ownerId to identify which vault to use.

Enum:"Referrer""MerchantGroup""Merchant""Site"
Example:MerchantGroup
gatewayTokenIdstring, (uuid)required

The gateway token ID.

Example:7f46c09d-d1d1-4f94-9a88-6e8ac32e6341
Bodyapplication/json
cardVerificationCodestring, [ 3 .. 4 ] charactersrequired

Represents the Card Verification Code (CVC) associated with the payment card, a security feature for transactions where the card is not physically present. The security code is typically a 3 or 4 digit number found on the card, used to verify that the cardholder is in possession of the card during non-face-to-face transactions.

Example:"123"
curl -i -X PUT \
  https://api-services.pxp.io/api/v1/token-vault/MerchantGroup/MERCHANT-GROUP-1/vaults/gateway-tokens/7f46c09d-d1d1-4f94-9a88-6e8ac32e6341/card-verification-code \
  -H 'Content-Type: application/json' \
  -d '{
    "cardVerificationCode": "123"
  }'

Responses

Successful storage of the card verification code

Response
No content