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
For request body parameter descriptions, refer to Query Card API.
{
"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 CompactAPI examples are shown in a human-readable format for clarity. Actual API request bodies must use compact JSON.
Card Query Response
For response field descriptions, refer to Query Card API response.
{
"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"
}
}
Note the eligibility of push and pull 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
6. Query Card
Open Recipe
Updated 2 days ago
Other Resources