What do cvc_check, address_line1_check and address_postal_code_check mean on the Charge object?

The cvc_check, address_line1_check and address_postal_code_check properties are available under the `payment_method_details.card.checks` hash when creating or retrieving a Charge. The properties can have different values/enums depending on the information we receive from a customer's bank, based on the details collected during the payment.

These properties can have the following enums:

  • pass: the value provided is correct and was checked by the bank.

  • fail: the value provided is incorrect and was checked by the bank.

  • unavailable: the value was provided but the bank explicitly did not check the information.

  • unchecked: the value was provided but has not yet been checked by the bank.

  • null: this indicates that the value was not collected.

Some card issuers do not support checking one or more of these parameters, in which case Stripe will return an unavailable result.

Also note that, depending on the card issuer, charges can succeed even when passed incorrect CVC and address information.

More information is available in our Charge API documentation in the Verification Response section.

Did this answer your question?