Store card CVCs

Store the card verification code (CVC) for a card associated with a gateway token.

Store a card CVC

POST

/v1/token-vault/{ownerType}/{ownerId}/vaults/gateway-tokens/{gatewayTokenId}/card-verification-code

Request example

Use the following request to store a card's CVC.

The CVC will be stored for 20 minutes before being automatically deleted.

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"
  }'

Path parameters

Parameter	Description
`ownerId` string (0 to 20 characters) required	The unique identifier of the entity that owns the token.
`ownerType` string (enum) required	The type of entity that owns the token. Possible values: `Referrer` `MerchantGroup` `Merchant` `Site`
`gatewayTokenId` string (UUID) required	The unique identifier of the gateway token, as assigned by PXP.

Body parameters

Parameter	Description
`cardVerificationCode` string (3-4 characters) required	The Card Verification Code (CVC) associated with the payment card. The CVC is a security feature for transactions where the card is not physically present. This is typically a 3 or 4 digit number found on the card.

Response example

If your request is successful, you'll receive an empty 200 response.