{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Reefpay Docs","description":"Reefpay is the groundbreaking payment gateway that lets you integrate with the future of payments."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"avs-and-cvv","__idx":0},"children":["AVS and CVV"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["AVS and CVV are the two fraud signals a card-not-present transaction gets for"," ","free. Both run during authorization, and both report back on the response."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Neither one declines a transaction on its own."]}," An issuer can approve a payment"," ","whose address did not match at all. Deciding what to do with a mismatch is your"," ","call, not ours."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-to-request-them","__idx":1},"children":["How to request them"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Both are driven by what you send in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment_method"]},":"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Check"},"children":["Check"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Send"},"children":["Send"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["AVS"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["billing_address"]},", especially ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["line1"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["postal_code"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["CVV"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cvv"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Omit them and the checks do not run. You lose the signal and, for AVS, usually"," ","pay a higher interchange rate — see"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/concepts/card-networks-and-interchange"},"children":["Card networks and interchange"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"avs-result-codes","__idx":2},"children":["AVS result codes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment_method.avs_result_code"]}," on the response."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Code"},"children":["Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Meaning"},"children":["Meaning"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Y"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Street address and postal code both matched"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Street address and full US ZIP+4 both matched"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["A"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Street address matched, postal code did not"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Z"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Postal code matched, street address did not"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["W"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["US ZIP+4 matched, street address did not"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["N"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Neither matched"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["U"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Address information unavailable"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["R"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retry — AVS was unavailable or timed out"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["S"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["AVS not supported by the issuer"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["P"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["AVS not applicable to this transaction"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["B"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No address supplied, or the transaction was declined"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["AVS not requested or not applicable. An ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["integer"]},", not a string"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["avs_response"]}," carries the same thing in words."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Note that ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]}," is an integer while every other value is a string. A strictly typed"," ","client needs to accept both."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cvv-results","__idx":3},"children":["CVV results"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment_method.cvv_result_code"]}," is a single character, most often ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["M"]}," for a"," ","match. It is not a closed enum in the API description — the processor's own value"," ","passes through, so treat an unfamiliar character as \"no useful signal\" rather"," ","than as a failure."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["It is null on void and refund responses, where CVV is not re-checked."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Never store a CVV."]}," Not encrypted, not hashed, not briefly. It is prohibited"," ","after authorization, and it is the single most common PCI finding."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"deciding-what-to-do","__idx":4},"children":["Deciding what to do"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A reasonable default for card-not-present:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Result"},"children":["Result"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Common handling"},"children":["Common handling"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["AVS ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Y"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X"]},", CVV match"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Accept"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["AVS ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Z"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["A"]},", CVV match"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Accept. Partial address mismatches are common and often innocent — a customer who moved, or a formatting difference"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["AVS ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["N"]},", CVV match"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Review, especially above a value threshold"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["CVV mismatch"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Treat as a strong signal regardless of AVS"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["AVS ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["U"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["R"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["S"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["P"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No signal. Decide on other grounds"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Tune the thresholds to your own fraud experience. Being strict costs you real"," ","customers; being loose costs you chargebacks."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":5},"children":["Next steps"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/payments/accept-a-card-payment"},"children":["Accept a card payment"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/payments/handle-declines"},"children":["Handle declines"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/reference/test-cards"},"children":["Test cards and test accounts"]}]}]}]},"headings":[{"value":"AVS and CVV","id":"avs-and-cvv","depth":1},{"value":"How to request them","id":"how-to-request-them","depth":2},{"value":"AVS result codes","id":"avs-result-codes","depth":2},{"value":"CVV results","id":"cvv-results","depth":2},{"value":"Deciding what to do","id":"deciding-what-to-do","depth":2},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"title":"AVS and CVV","shortTitle":"AVS and CVV","intro":"Two checks that run alongside an authorization, what each result code means, and why the decision about them is yours.","type":"overview","seo":{"title":""}},"lastModified":"2026-09-17T12:59:03.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/concepts/avs-and-cvv","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}