Validate Card

Validate a card using card number and cvv.

Request
Security:
path Parameters
version
required
string
Request Body schema: application/json
card_number
string or null

Card number

cvx2
string or null

CVX2 data

expiration_date
string or null

Expiration date in format YYMM

card_proxy
string or null

Card proxy

card_lastX
string or null

Last X digits of cardnumber

ssn_last4
string or null

Last 4 digits of SSN. Optional Parameter for Multi Factor Authentication.

birth_date
string or null

Person’s date of birth. Optional Parameter for Multi Factor Authentication. Accepted Format: yyyy-MM-dd

postal_code
string or null <= 10 characters

Postal code corresponding to the address. Optional Parameter for Multi Factor Authentication.

client_reference_id
string or null

API Partner can send the person's unique id on their system and it can be used to fetch person detail. Optional Parameter for Multi Factor Authentication.

person_guid
string <uuid>

Person’s Unique Identifier on Qolo platform.

program_guid
string or null <uuid>

Program Unique Identifier on Qolo platform.

object (JournalEntry)
iin
string or null

JournalEntry info

Responses
200

Returns the card details

400

Bad request

401

Unauthorized

404

Card not found

500

Server Error

post/api/{version}/cards/validate
Request samples
application/json
{
  • "card_number": "string",
  • "cvx2": "string",
  • "expiration_date": "string",
  • "card_proxy": "string",
  • "card_lastX": "string",
  • "ssn_last4": "string",
  • "birth_date": "string",
  • "postal_code": "string",
  • "client_reference_id": "string",
  • "person_guid": "2ae6ba4b-f6c0-4817-a158-43e5a87168fd",
  • "program_guid": "3fa0d2ea-ffcf-485d-94ed-dbf4f861ad2f",
  • "journal_entry": {
    • "card_proxy": "string",
    • "user_guid": "2c9a19c5-ac85-4da0-8708-2b80265927da",
    • "source_code": "string",
    • "company_guid": "e7c8755b-aece-46c7-a1c9-897cfb55ba0c"
    },
  • "iin": "string"
}
Response samples
application/json
{
  • "card_number": "5340920000000007",
  • "card_proxy": "cproxy0000000000001",
  • "mask_card_pan": "534092XXXXXX0007",
  • "wallet_guid": "05a28e5a-01a6-4a3e-8ce3-ca30fc09e5ae",
  • "issuance_type": "FULL",
  • "card_condition": "ORIGINAL",
  • "card_status": "PENDING",
  • "activation_method": "ONLOAD",
  • "expiration_date": "2212",
  • "logical_expiration_date": "0001-01-01T00:00:00",
  • "person_card_status": "ACTIVE",
  • "card_tracking_detail": {
    • "fulfillment_house_name": "Arroweye",
    • "card_requested": "0001-01-01T00:00:00",
    • "card_shipment_date": "0001-01-01T00:00:00",
    • "card_delivery_method": "USPS",
    • "card_delivery_tracking_number": "1234365465",
    • "card_package_name": "TestPlacardPkg"
    },
  • "sys_utcinserted": "0001-01-01T00:00:00",
  • "sys_utcupdated": "0001-01-01T00:00:00"
}
Copyright © 2023 KeyBank & Qolo. All rights reserved.