Querying for credit cards
GET/api/v3/creditcard
Available query parameter values for filtering:
- creditcard_id
- customer_id
- external_key
- token
Request
Query Parameters
customer_id:EQUALS:1000
creditcard_id:ASC
2
8
Responses
- 200
- 400
- 401
Object was fetched successfully
- application/json
- Schema
- Example (from schema)
- Example 1
Schema
Array [
]
response
object[]
The customer id #
The credit card ID #
Unique external key value
Credit card type
Credit card type user-friendly name
Credit card token
Name on credit card
Last 4 digits of the credit card
First 6 digits and last 4 digits of the credit card
Expiration date (in YYYY-MM-DD format)
Expiration year (4-digits, YYYY) (only required if you do not provide expdate)
Expiration month (2-digits, MM) (only required if you do not provide expdate)
Expiration date (formatted)
Billing street address
Billing city
Billing state
Billing postal code
Billing country
Date/time the credit card was stored
IP address that created the card
Date/time the credit card was modified
{
"code": 0,
"status": "string",
"message": "string",
"details": {},
"response": [
{
"customer_id": 0,
"creditcard_id": 0,
"external_key": "string",
"type": "string",
"type_name": "string",
"token": "string",
"name": "string",
"mask_number": "string",
"mask_and_bin_number": "string",
"expdate": "string",
"expdate_year": "string",
"expdate_month": "string",
"expdate_formatted": "string",
"address": "string",
"city": "string",
"state": "string",
"postcode": "string",
"country": "string",
"url_updatelink": "string",
"write_datetime": "string",
"write_ipaddr": "string",
"mod_datetime": "string"
}
]
}
{
"code": 200,
"status": "OK",
"message": "",
"details": {},
"response": [
{
"creditcard_id": 1,
"external_key": null,
"type": "visa",
"token": "ly1j7wmginqp",
"expdate": "2023-05-01",
"write_datetime": "2019-07-25 10:24:52",
"write_ipaddr": "10.80.1.1",
"mask_number": "x1111",
"mask_and_bin_number": "411111xxx1111",
"name": "John LLC",
"expdate_month": "5",
"expdate_year": "2023",
"expdate_formatted": "May 2023",
"type_name": "Visa",
"url_updatelink": "http://dev1.chargeover.test/r/paymethod/i/ru0895x81ht1",
"address": null,
"city": null,
"postcode": null,
"country": "United States",
"customer_id": 2
},
{
"creditcard_id": 2,
"external_key": null,
"type": "mast",
"token": "4ei8py0h1x06",
"expdate": "2022-05-01",
"write_datetime": "2019-07-25 10:25:37",
"write_ipaddr": "10.80.1.1",
"mask_number": "x4444",
"mask_and_bin_number": "555555xxx4444",
"name": "John LLC",
"expdate_month": "5",
"expdate_year": "2022",
"expdate_formatted": "May 2022",
"type_name": "MasterCard",
"url_updatelink": "http://dev1.chargeover.test/r/paymethod/i/ru0895x81ht1",
"address": null,
"city": null,
"postcode": null,
"country": "United States",
"customer_id": 2
}
]
}
Bad request
- application/json
- Schema
- Example (from schema)
- Example 1
Schema
{
"code": 0,
"status": "string",
"message": "string",
"details": {},
"response": true
}
{
"code": 400,
"status": "Error",
"message": "Missing or invalid parameter.",
"details": {},
"response": false
}
Authentication error
- application/json
- Schema
- Example (from schema)
- Example 1
Schema
{
"code": 0,
"status": "string",
"message": "string",
"details": {},
"response": true
}
{
"code": 401,
"status": "Error",
"message": "Invalid or incorrect authorization [Missing (basic) authorization header.]",
"details": {},
"response": false
}