Account verification

Validity and status of a card account can be verified.

A response from 3ds service will be required, otherwise a verification required error will be returned.

Account verification is most often (but not always) used as an initial payment in a series of subsequent payments made with the verified card.

In order to later perform a Customer or Merchant initiated payment with the verified card a reference to this initial verification charge will need to be provided. The reference is returned in the card verification response.

For PSPs using Automated integration (Intergiro 3DS service)

POST /v1/authorization/redirect
{
  "amount": 0, 
  "currency": "EUR",
  "card": {
    "pan": "4111111111111111",
    "expires": [2, 22],
    "csc": "987"
  },
  "recurring": "initial",
  "target": "<callback_url>"
}

For PSPs using External integration (PSPs own 3DS service)

POST /v1/authorization
{
  "amount": 0, 
  "currency": "EUR",
  "card": {
    "pan": "4111111111111111",
    "expires": [2, 22],
    "csc": "987",
    "verification": <3ds data>
  },
  "recurring": "initial"
}

Response:

{
  "id": "<intergiro_tx_id>",
  "merchant": "<merchant_id>",
  "reference": "<initial_reference>",
  "created": "2021-04-01T09:00:00.000Z",
  "amount": 0,
  "currency": "EUR",
  "card": {
    "csc": "matched",
    "expires": [2, 24],
    "iin": "411111",
    "last4": "1111",
    "scheme": "visa",
    "type": "debit",
  },
  "recurring": "initial",
  "history": [],
  "capture": [],
  "refund": [],
  "status": {
      "authorized": 0
  },
  "changed": "2023-02-20T12:25:02.134Z"
}