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
JSON Name			Value	Description	200	207	Other	Conditional
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

🦉

6. Query Card

Open Recipe