Address and CVV verification

AVS verification can be performed in the authorization process by providing the cardholder's billing address in the Authorization Creatable. It's also required to include the cardholder name in the card property when performing AVS authentication.

CVV verification (referred to as CSC in Intergiro API) is also performed automatically when provided as part of card details.

POST /v1/authorization

Host: merchant.intergiro.com
Content-Type: application/json
Authentication: Bearer <public.api.key>
Accept: application/json+camelcase
{
    "number": "<psp-id>",
    "amount": 10,
    "currency": "EUR",
    "card": {
        "pan": "4111111111111111",
        "expires": [
            1,
            28
        ],
        "csc": "987",
        "cardholderName": "<cardholder-name>"
    },
    "billing_address": {
        "country_code": "SE",
        "street": "Street name",
        "zipCode": "12345",
        "city": "Stockholm"
    },
    "target": "<callback-url>",
    "browser": {
        "color_depth": 32,
        "java": false,
        "javascript": true,
        "locale": "en-GB",
        "timezone": 0,
        "resolution": [800, 600],
        "ip_country": "SE"
    }
}

Response

{
    "id": "<intergiro-tx-id>",
    "merchant": "<merchant-id>",
    "number": "<psp-id>",
    "reference": "<processor-id>",
    "created": "2024-03-21T16:26:18.124Z",
    "amount": 10,
    "currency": "EUR",
    "card": {
        "iin": "411111",
        "last4": "1111",
        "scheme": "visa",
        "country": "SE",
        "expires": [1, 28],
        "csc": "matched",
        "category": "customer",
        "type": "debit",
        "issuer": {
            "name": "Testbank"
        },
        "cardholder_name":  "<cardholder-name>"
    },
    "history": [],
    "capture": [],
    "refund": [],
    "category": "purchase",
    "status": {
        "authorized": 10
    },
    "processor": {
        "mid": "<processor-merchant-id>",
        "entry": "e-commerce",
        "reference": {
            "transaction": "<processor-id>",
            "retrieval": "<retrieval-reference-number>",
            "scheme": "<scheme-id>"
        },
        "response": {
            "avs": "match",
            "avs_result_code": "Y",
            "code": "00",
            "csc": "matched",
            "csc_result_code": "M",
            "description": "Approved"
        },
        "code": "<authorization code>",
        "eci": "05"
    }
}

Verification results

Intergiro response field	ISO8583 source for Mastercard	ISO8583 source for Visa
avs_result_code	Contents of field 48, subelement 83	Contents of field 44, subfield 2
csc_result_code	Contents of field 48, subelement 87	Contents of field 44, subfield 10