CVV result

When enabled for your account, card payment responses include card.cvv_result, the result of the card verification value (CVV) check performed during the payment. This field is also sent in payment notifications.

Response field

card.cvv_result is a response-only string. It's returned in the synchronous payment response and in payment notifications.

Value	Meaning
`match`	The CVV matches.
`not_matched`	The CVV does not match.
`not_verified`	The CVV was not verified, for example when no CVV is sent or the processor does not return a result.

The value is the one reported by the processor, in $0 authorization, authorization, and sale alike. Support depends on the processor.

📘
Availability
This field is available upon request. To enable it, contact your Technical Account Manager.

Example responses

{
    "id": "T-40004-eebc14d9-8381-4bf6-b8b7-82acbb06f166",
    "amount": 0,
    "currency": "BRL",
    "payment_method_id": "CARD",
    "payment_method_type": "CARD",
    "payment_method_flow": "DIRECT",
    "country": "BR",
    "card": {
        "holder_name": "Thiago Gabriel",
        "expiration_month": 7,
        "expiration_year": 2024,
        "brand": "VI",
        "last4": "8528",
        "cvv_result": "match"
    },
    "created_date": "2024-01-15T14:22:31.000+0000",
    "approved_date": "2024-01-15T14:22:31.000+0000",
    "status": "VERIFIED",
    "status_detail": "The payment was verified.",
    "status_code": "700",
    "order_id": "BENtest-h8fJ8blU",
    "notification_url": "https://merchant.example/notifications"
}

{
    "id": "T-4-ab3de12f-11c4-4781-a3ea-c2e1cc5b231a",
    "amount": 100.00,
    "currency": "BRL",
    "payment_method_id": "CARD",
    "payment_method_type": "CARD",
    "payment_method_flow": "DIRECT",
    "country": "BR",
    "payer": {
        "id": "111111111",
        "name": "John Doe",
        "email": "[email protected]"
    },
    "card": {
        "holder_name": "John Doe",
        "expiration_month": 6,
        "expiration_year": 2026,
        "brand": "MC",
        "last4": "4444",
        "cvv_result": "not_matched"
    },
    "created_date": "2024-01-15T14:22:31.000+0000",
    "approved_date": "2024-01-15T14:22:31.000+0000",
    "status": "PAID",
    "status_detail": "The payment was paid.",
    "status_code": "200",
    "order_id": "order-001",
    "notification_url": "https://merchant.example/notifications"
}