Skip to content

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 create a gateway token.

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

ParameterDescription
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

ParameterDescription
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.