{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Reefpay Docs","description":"Reefpay is the groundbreaking payment gateway that lets you integrate with the future of payments.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"about-fraud-prevention","__idx":0},"children":["About fraud prevention"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"fraud-prevention-layers","__idx":1},"children":["Fraud prevention layers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Effective fraud prevention combines multiple verification methods.","Reefpay"," integrates several checks that run automatically during transaction authorization."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"https://files.modern-mermaid.live/images/1776270755946-mermaid-diagram-1776270756131.png","alt":"image"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"address-verification-service-avs","__idx":2},"children":["Address Verification Service (AVS)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["AVS compares the billing address provided in the transaction with the address on file at the card-issuing bank. The check happens automatically when you include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address_line1"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["zip"]}," in the payment method."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"how-to-send-avs-data","__idx":3},"children":["How to send AVS data"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Include the address fields in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment_method"]}," object."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"type\": \"sale\",\n  \"amount\": 1999,\n  \"payment_method\": {\n    \"type\": \"card\",\n    \"pan\": \"4111111111111234\",\n    \"expiry\": {\n      \"month\": \"03\",\n      \"year\": \"2028\"\n    },\n    \"cardholder_name\": \"John Doe\",\n    \"cvv\": \"456\",\n    \"address_line1\": \"123 Main St\",\n    \"zip\": \"62704\",\n    \"cvv\": \"456\"\n  },\n  \"metadata\": {},\n  \"recurring\": false,\n  \"purchase_description\": \"Dog food\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"avs-result-codes","__idx":4},"children":["AVS result codes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["avs_result_code"]}," field in the transaction response indicates the match result."]},{"$$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":{"align":"left","data-label":"Code"},"children":["Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Risk level"},"children":["Risk level"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["y"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Street address and postal code both match"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Low"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["x"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Street address and ZIP+4 both match"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Low"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["a"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Street address matches, postal code does not"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Medium"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["z"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Postal code matches, street address does not"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Medium"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["w"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["ZIP+4 matches, street address does not"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Medium"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Neither street address nor postal code matches"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["High"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["b"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No address information provided or transaction declined"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Review required"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["r"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["AVS unavailable or timed out — retry"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Retry"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["s"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["AVS not supported by card issuer"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Not applicable"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["u"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Address information unavailable"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Not applicable"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["p"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["AVS not applicable for this transaction"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Not applicable"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"interpreting-avs-results","__idx":5},"children":["Interpreting AVS results"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Paradise Pay returns the AVS result but does not automatically decline transactions based on AVS mismatch. It is your responsibility to decide how to handle each result."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Recommended approach:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["y"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["x"]}]}," — proceed with the transaction."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["a"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["z"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["w"]}]}," — partial match; proceed with caution or request the person to verify their address."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["n"]}]}," — no match; consider declining or flagging for manual review."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["r"]}]}," — retry the transaction."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["s"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["u"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["p"]}]}," — AVS not available; rely on other fraud signals."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"AVS is advisory"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["AVS results are informational. The processor may still approve a transaction with an AVS mismatch. Implement your own business logic to decide whether to fulfill orders based on AVS results."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cvv-verification","__idx":6},"children":["CVV verification"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Card Verification Value (CVV / CVC / CID) is the 3- or 4-digit code printed on the physical card. Including the CVV in a transaction proves the person has possession of the card, reducing the risk of fraud from stolen card numbers."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"how-to-send-cvv","__idx":7},"children":["How to send CVV"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Include the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cvv"]}," field in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment_method"]}," object."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\"payment_method\": {\n  \"type\": \"card\",\n  \"pan\": \"4111111111111234\",\n  \"expiry\": {\n    \"month\": \"03\",\n    \"year\": \"2028\"\n  },\n  \"cardholder_name\": \"John Doe\",\n  \"cvv\": \"456\"\n},\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cvv-result-codes","__idx":8},"children":["CVV result codes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cvv_result"]}," field in the response indicates whether the CVV matched."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"visa","__idx":9},"children":["Visa"]},{"$$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":{"align":"left","data-label":"Code"},"children":["Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["M"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["CVV match"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["N"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["CVV no match"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["P"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Not processed"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["S"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Merchant indicated CVV not present on card"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["U"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Issuer not certified / no encryption keys"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"mastercard","__idx":10},"children":["Mastercard"]},{"$$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":{"align":"left","data-label":"Code"},"children":["Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Authentication failed"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Authentication attempted — liability shift applies"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Authentication successful — full protection"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"american-express","__idx":11},"children":["American Express"]},{"$$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":{"align":"left","data-label":"Code"},"children":["Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["AEVV failed — authentication, issuer key"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["AEVV passed — authentication, issuer key"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["3"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["AEVV passed — attempt, issuer key"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["4"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["AEVV failed — attempt, issuer key"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["7"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["AEVV failed — attempt, issuer not participating, network key"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["8"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["AEVV passed — attempt, issuer not participating, network key"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["9"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["AEVV failed — attempt, ACS not available, network key"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["A"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["AEVV passed — attempt, ACS not available, network key"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["U"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["AEVV unchecked"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"interpreting-cvv-results","__idx":12},"children":["Interpreting CVV results"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Match (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["M"]}," for Visa, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2"]}," for Mastercard)"]}," — proceed normally."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["No match (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["N"]}," for Visa, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]}," for Mastercard)"]}," — high fraud risk; consider declining."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Not processed / unavailable"]}," — rely on other fraud signals."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"CVV is never stored"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["PCI-DSS prohibits storing CVV after authorization.","Reefpay"," discards the CVV immediately after the authorization check. For tokenized (stored) transactions, CVV is not required or available."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"address-check-on-tokenized-cards","__idx":13},"children":["Address check on tokenized cards"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you create a payment token with address data,","Reefpay"," verifies the address with the card issuer and returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address_check"]}," results."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"payment_token\": \"PAYMENT_TOKEN-01KFDKXMQ637EKEAY410MSQSXB\",\n  \"address_check\": {\n    \"address_line1_match\": \"match\",\n    \"address_zip_match\": \"match\"\n  },\n  \"brand\": \"visa\",\n  \"last_four\": \"1234\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This lets you verify the person's address at tokenization time, before any transaction is processed."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"combining-fraud-signals","__idx":14},"children":["Combining fraud signals"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["No single check is sufficient on its own. Use multiple signals together for effective fraud prevention."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"https://files.modern-mermaid.live/images/1776270828244-mermaid-diagram-1776270828411.png","alt":"image"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"recommended-fraud-decision-matrix","__idx":15},"children":["Recommended fraud decision matrix"]},{"$$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":{"align":"left","data-label":"CVV result"},"children":["CVV result"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"AVS result"},"children":["AVS result"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Suggested action"},"children":["Suggested action"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Match"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Full match (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["y"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["x"]},")"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Fulfill order"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Match"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Partial match (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["a"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["z"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["w"]},")"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Fulfill low-value; review high-value"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Match"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No match (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["n"]},")"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Flag for review or decline"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No match"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Any"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Decline"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Unavailable"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Full match"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Fulfill with monitoring"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Unavailable"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No match"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Decline or hold for review"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"additional-fraud-prevention-measures","__idx":16},"children":["Additional fraud prevention measures"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Beyond AVS and CVV, consider implementing these application-level controls."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"velocity-checks","__idx":17},"children":["Velocity checks"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Monitor transaction frequency to detect automated fraud attempts."]},{"$$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":{"align":"left","data-label":"Check"},"children":["Check"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Example threshold"},"children":["Example threshold"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Action"},"children":["Action"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Transactions per card per hour"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["> 5"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Block and alert"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Declined transactions per IP"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["> 3 in 10 minutes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Temporary IP block"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Total amount per card per day"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["> 5,000.00 USD"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Require additional verification"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"order-level-signals","__idx":18},"children":["Order-level signals"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Shipping vs. billing address mismatch"]}," — higher fraud risk for card-not-present transactions."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Email domain"]}," — free email providers correlate with higher fraud rates."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Device fingerprinting"]}," — repeated attempts from the same device with different cards."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Geolocation"]}," — IP location differs significantly from billing address."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"3d-secure-3ds","__idx":19},"children":["3D Secure (3DS)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["3D Secure adds an issuer-controlled authentication step (for example, Visa Secure, Mastercard Identity Check). When the cardholder successfully authenticates, liability for fraudulent chargebacks shifts from the merchant to the issuing bank."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"further-reading","__idx":20},"children":["Further reading"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/concepts/security-compliance/pci-dss-overview"},"children":["About PCI-DSS compliance"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/concepts/security-compliance/data-protection"},"children":["About data protection"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/concepts/api-fundamentals/error-handling"},"children":["About error handling"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/get-started/integration-best-practices"},"children":["Integration best practices"]}]}]}]},"headings":[{"value":"About fraud prevention","id":"about-fraud-prevention","depth":1},{"value":"Fraud prevention layers","id":"fraud-prevention-layers","depth":2},{"value":"Address Verification Service (AVS)","id":"address-verification-service-avs","depth":2},{"value":"How to send AVS data","id":"how-to-send-avs-data","depth":3},{"value":"AVS result codes","id":"avs-result-codes","depth":3},{"value":"Interpreting AVS results","id":"interpreting-avs-results","depth":3},{"value":"CVV verification","id":"cvv-verification","depth":2},{"value":"How to send CVV","id":"how-to-send-cvv","depth":3},{"value":"CVV result codes","id":"cvv-result-codes","depth":3},{"value":"Visa","id":"visa","depth":4},{"value":"Mastercard","id":"mastercard","depth":4},{"value":"American Express","id":"american-express","depth":4},{"value":"Interpreting CVV results","id":"interpreting-cvv-results","depth":3},{"value":"Address check on tokenized cards","id":"address-check-on-tokenized-cards","depth":2},{"value":"Combining fraud signals","id":"combining-fraud-signals","depth":2},{"value":"Recommended fraud decision matrix","id":"recommended-fraud-decision-matrix","depth":3},{"value":"Additional fraud prevention measures","id":"additional-fraud-prevention-measures","depth":2},{"value":"Velocity checks","id":"velocity-checks","depth":3},{"value":"Order-level signals","id":"order-level-signals","depth":3},{"value":"3D Secure (3DS)","id":"3d-secure-3ds","depth":3},{"value":"Further reading","id":"further-reading","depth":2}],"frontmatter":{"title":"About fraud prevention","shortTitle":"Fraud prevention","intro":"Paradise Pay provides built-in fraud prevention tools including Address Verification Service (AVS), CVV verification, and processor-level checks. Use these tools together to reduce fraudulent transactions and chargebacks.","type":"overview","seo":{"title":""}},"lastModified":"2026-06-05T02:46:44.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/concepts/security-compliance/fraud-protection","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}