Documentation
API ReferenceRecipesChangelogCommunity
Start typing to search…

Card Verification and Eligibility Check

Verify card for specific payments.

Prior to confirming an instant payment, TabaPay allows our customers to verify eligibility of source/destination accounts for transaction eligibility and whether their BINs qualify for pull or push respectively.

The Query Card API request allows you to simultaneously verify Address using AVS as well as Card Security Code (CSC), or CVV2 Verification.

Card Query Request

{
  "card": {
    "accountNumber": "4111111111111111",
    "expirationDate": "202708",
    "securityCode": "232"
  },
  "owner": {
    "name": {
      "first": "Test",
      "last": "Name"
    },
    "address": {
      "line1": "123 Street",
      "city": "San Francisco",
      "state": "CA",
      "zipcode": "94104",
      "country": "840"
    }
  },
  "currency": "840",
  "timeout": "39"
}

📘

Payload Should Be Compact

API examples are shown in a human-readable format for clarity. Actual API request bodies must use compact JSON.

Card Query Response

Check eligibility before performing transaction with the payment instrument.

{
  "SC": 200,
  "EC": "0",
  "card": {
    "bin": "411111",
    "last4": "1111",
    "nameFI": "Financial Institution Name",
    "pull": {
      "enabled": true,
      "network": "Visa",
      "type": "Debit",
      "regulated": true,
      "currency": "840",
      "country": "840"
    },
    "push": {
      "enabled": true,
      "network": "Visa",
      "type": "Debit",
      "regulated": true,
      "currency": "840",
      "country": "840",
      "availability": "Immediate"
    }
  }
}
{
  "SC": 200,
  "EC": "0",
  "card": {
    "pull": {
      "enabled": true,
      "network": "Visa",
      "type": "Credit",
      "regulated": true,
      "currency": "840",
      "country": "840"
    },
    "push": {
      "enabled": true,
      "network": "Visa",
      "type": "Credit",
      "availability": "Immediate",
      "regulated": true,
      "currency": "840",
      "country": "840"
    },
    "bin": "411111",
    "last4": "1111",
    "nameFI": "FORD Instiution"
  },
  "AVS": {
    "avsID": "hz8pVrQTCa8IDpu3-v_wcA",
    "networkRC": "85",
    "networkID": "501419181603",
    "authorizeID": "181603",
    "codeAVS": "Y",
    "codeSecurityCode": "M",
    "par": "V0010013022073812195104907179"
  }
}

Eligibility criteria returned in the response.

JSON Name Value Description Status Code Conditional
200 207 Other
card object Card Attributes ✔ ✔
bin String First 6 Digits of Card Number ✔ ✔
last4 String Last 4 Digits of Card Number ✔ ✔
nameFI String Issuer Name O O
pull object Debit Transaction ✔ ✔
enabled Boolean ✔ ✔
network String O O
type String Credit, Debit, PrePaid O O
regulated Boolean O O
currency String
3-digit code		 ISO 4217 Currency Number O O
country String
3-digit code		 ISO 3166-1 Country Code O O
push object Credit Transaction ✔ ✔
enabled Boolean ✔ ✔
network String O O
type String Credit, Debit, Prepaid O O
availability String Estimated Funds Availability O O
regulated Boolean O O
currency String
3-digit code		 ISO 4217 Currency Number O O
country String
3-digit code		 ISO 3166-1 Country Code O O
AVS object AVS Results C C AVS
avsID String
22-characters		 AVS Transaction Identifier ✔ O AVS
networkRC String
2 or 3-character code		 Network Response Code ✔ O AVS
networkID String Network Identification Code ✔ O AVS
authorizeID String ID ✔ O AVS
resultText String AVS Result Text ✔ O AVS
codeAVS String AVS Response Code ✔ O AVS
codeSecurityCode String Security Code Response Code ✔ O AVS
par String Payment Account Reference ✔ O AVS

Recipe

Updated 5 days ago

What’s Next