# Get cards associated to payer

This endpoint enables you to retrieve details of cards associated to a payer

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

Request example

Shell
JavaScript


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

Response example

{ 
  "count": 1,  
  "credit_cards": [{
      "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

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

# Response

{ 
    "count": 1,  
    "credit_cards": [{
        "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

credit_cards object

Parameter	Type	Description
count	int	Number of cards associated to a Payer
credit_cards	arrayOf(credit_card)	Array containing credit cards associated to the payer. The first one in the list is the default one.

# 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 payer by id Get card associated to payer →