# Get card associated to payer

This endpoint enables you to retrieve details of a specific card associated to a payer

GET: https://api.openacquiring.com/v1/merchants/YOUR_MERCHANT_ID/payer/PAYER_ID/card/CREDIT_CARD_ID

Request example

Shell
JavaScript


curl -X GET \
 https://api.openacquiring.com/v1/merchants/w3z8dfhkzvfq0j9n/payer/0f053a05-9fa2-49a1-871f-3098e4b114e2/card/9c22d208-4e25-47f8-8d32-c0e6d97c17c2 \
  -H 'authorization: Basic ODZidWQ0Y2JremlxOXZmYzoweHI1ZDkwOHo2bmo4a2h6' \
  -H 'content-type: application/json'

Response example

{
  "id": "9c22d208-4e25-47f8-8d32-c0e6d97c17c2",
  "type": "Visa",
  "expire_month": 12,
  "expire_year": 2020,
  "name": "Tom Hanks",
  "cvv_check": "Y",
  "avs_check": "S",
  "last4": "4821",
  "bin": "400552",
  "is_default": true,
  "bin_data": {
      "bin": "400552",
      "country_code": "MU",
      "country_name": "Mauritius",
      "bank_name": "MCB",
      "card_scheme": "Visa",
      "card_type": "Credit",
      "card_category": "1"
  }
}

# Request

# Header parameters

The request require a Basic authentication in the header. For more information about HTTP request headers, see HTTP request headers.

# Request parameters

# merchant_id string required

Encrypted Merchant account identifier for the Merchant.
# payer_id string required

unique identifier of a payer on our system.
# credit_card_id string required

unique identifier of a credit card on our system.

Parameter	Type	Description
merchant_id required	string	Encrypted Merchant account identifier for the Merchant
payer_id required	string	unique identifier of a payer on our system
credit_card_id required	string	unique identifier of a credit card on our system

# Response

{
  "id": "9c22d208-4e25-47f8-8d32-c0e6d97c17c2",
  "type": "Visa",
  "expire_month": 12,
  "expire_year": 2020,
  "name": "Tom Hanks",
  "cvv_check": "Y",
  "avs_check": "S",
  "last4": "4821",
  "bin": "400552",
  "is_default": true,
  "bin_data": {
      "bin": "400552",
      "country_code": "MU",
      "country_name": "Mauritius",
      "bank_name": "MCB",
      "card_scheme": "Visa",
      "card_type": "Credit",
      "card_category": "1"
  }
}

# Response Body

# Status 200 Success

Parameter	Type	Description
id	string	ID of the credit card being saved for later use.
number	string	The credit card number. Value is numeric characters only with no spaces or punctuation. Must conform to the modulo and length required by each credit card type.
expire_month	integer	The expiration month with no leading zero. Value is from `1` to `12`.
expire_year	integer	The four-digit expiration year
cvv2	string	The three to four digit card validation code
name	string	The card holder's name as displayed on the card
stored	bool	Indicate the origin of the card details on a full card API Call. Default : `false`. This must be set to true for payments that use store card details (usually if you have a merchant which is PCI Compliant and they are sending you the full card details and the origin of these card details is On File)
type	string	Credit card type. Valid types are: `visa`, `mastercard`, `discover`, `amex`, `UPI`, `JCB`
state	string	State of the credit card funding instrument
cvv_check	string	Raw CVV result received from the acquirer, where available
avs_check	string	The AVS result code of the payment, which provides information about the outcome of the AVS check.
last4	string	Last 4 digit of a credit card number
bin	string	The Bank Identification Number of a credit card, which is the first six digits of a card number
is_default	bool	Indicate if the card is the default one associated to a Payer
fingerprint	string	A string containing the credit card fingerprint.
bin_data	object	Bin data corresponding to the credit card

bin_data object

Parameter	Type	Description
bin	string	one time use tokenized credit card details
country_code	string	Issuing bank country code
country_name	string	Issuing bank country name
bank_name	string	Issuing bank name
card_scheme	string	Credit card scheme
card_type	string	Type of the card, DEBIT, CREDIT
card_category	string	Category of the card

# Error Response Body

# Status 400 Bad Request

Parameter	Type	Description
code	string	Code indentifying the error on our system
name	string	Name indentifying the error on our system
message	string	Message related to the error
eventId	string	Unique Identifier for the request

← Get cards associated to payer Update payer default card →

# Get card associated to payer

# Request

# Header parameters

# Request parameters

# merchant_id `string` required

# payer_id `string` required

# credit_card_id `string` required

# Response

# Response Body

# Status 200 Success

# Error Response Body

# Status 400 Bad Request

# Get card associated to payer

# Request

# Header parameters

# Request parameters

# merchant_id string required

# payer_id string required

# credit_card_id string required

# Response

# Response Body

# Status 200 Success

# Error Response Body

# Status 400 Bad Request

# merchant_id `string` required

# payer_id `string` required

# credit_card_id `string` required