Get Cardholder by Cardholder ID from C2P

POST

click2pay

VISA

customer

{customerId}

Get Cardholder by Cardholder ID from C2P

curl --request POST \
  --url 'https://integration-api-cat2.{{environment}}.ext.{{realm}}.cia.enfuce.com/wallet/v1/click2pay/VISA/customer/{customerId}' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customerBID": "123456"
}
'

{
  "customerInformation": {
    "email": [
      "alex123@hotmail.com"
    ],
    "locale": "en_US",
    "phone": [
      "16504005555"
    ],
    "lastName": "Miller",
    "firstName": "Alex",
    "middleName": "Robert",
    "countryCode": "USA",
    "status": "ACTIVE"
  },
  "paymentInstruments": [
    {
      "tokenDetails": {
        "tokenReferenceID": "hflasdhflsdkfhoin3y038yfwn",
        "tokenRequestorID": "1234567890"
      },
      "cardId": "<string>",
      "status": "ACTIVE",
      "nameOnCard": "John Doe",
      "billingAddress": {
        "country": "USA"
      }
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

customerId

string<biginteger>

required

The customer id of which customer you want to get.

Query Parameters

auditUser

string

required

The audit user to log the request.

Body

application/json

customerBID

string

required

Unique identifier assigned to each issuer. Note: If you are using our BIN sponsorship, we provide you the customerBID; else, Visa provides you the customerBID.

Example:

"123456"

Response

Successful Get

customerInformation

object

Show child attributes

customerInformation.email

string[]

Customer's email address

Maximum string length: 256

customerInformation.locale

string<iso-639-1>

Language and country in which the product communicates with the customer

Example:

"en_US"

customerInformation.phone

string[]

Customer's phone number according to ITU-T E.164 (2010) number structure. Do not use the "+" symbol.

Required string length: 1 - 16

customerInformation.lastName

string

Customer's last name

Example:

"Miller"

customerInformation.firstName

string

Customer's first name

Example:

"Alex"

customerInformation.middleName

string

Customer's middle name

Example:

"Robert"

customerInformation.countryCode

string

Country code using 3-character ISO 3166 (Alpha 3) format

Example:

"USA"

customerInformation.status

enum<string>

Card status on C2P

Available options:

ACTIVE,

DISABLED

Example:

"ACTIVE"

paymentInstruments

object[]

Show child attributes

paymentInstruments.tokenDetails

object

Token details

Show child attributes

paymentInstruments.tokenDetails.tokenReferenceID

string

required

Token reference ID

Required string length: 1 - 50

Example:

"hflasdhflsdkfhoin3y038yfwn"

paymentInstruments.tokenDetails.tokenRequestorID

string

required

Token requestor ID

Required string length: 1 - 11

Example:

"1234567890"

Example:

{
  "tokenReferenceID": "hflasdhflsdkfhoin3y038yfwn",
  "tokenRequestorID": "1234567890"
}

paymentInstruments.cardId

string

The card id of which card you want to enroll with

paymentInstruments.status

enum<string>

Card status on C2P

Available options:

ACTIVE,

DISABLED

Example:

"ACTIVE"

paymentInstruments.nameOnCard

string

Name that appears on the card

Required string length: 1 - 120

Example:

"John Doe"

paymentInstruments.billingAddress

object

Billing Address details

Show child attributes

paymentInstruments.billingAddress.country

string<ISO 3166-1-alpha3>

required

Country code using 3-character ISO 3166 (Alpha 3) format

Required string length: 3

Example:

"USA"

paymentInstruments.billingAddress.city

string

City

Required string length: 1 - 32

Example:

"San Francisco"

paymentInstruments.billingAddress.postalCode

string

Postal code of the address

Required string length: 1 - 9

Example:

"94105"

paymentInstruments.billingAddress.addressLine1

string

Address Line 1

Required string length: 1 - 64

Example:

"1000 Market Street"

paymentInstruments.billingAddress.addressLine2

string

Address line 2

Required string length: 1 - 64

Example:

"Building 56"

paymentInstruments.billingAddress.addressLine3

string

Address line 3

Required string length: 1 - 64

Example:

"Suite 101"

Example:

{ "country": "USA" }

⌘I

Get Cardholder by Cardholder ID from C2P

curl --request POST \
  --url 'https://integration-api-cat2.{{environment}}.ext.{{realm}}.cia.enfuce.com/wallet/v1/click2pay/VISA/customer/{customerId}' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customerBID": "123456"
}
'

{
  "customerInformation": {
    "email": [
      "alex123@hotmail.com"
    ],
    "locale": "en_US",
    "phone": [
      "16504005555"
    ],
    "lastName": "Miller",
    "firstName": "Alex",
    "middleName": "Robert",
    "countryCode": "USA",
    "status": "ACTIVE"
  },
  "paymentInstruments": [
    {
      "tokenDetails": {
        "tokenReferenceID": "hflasdhflsdkfhoin3y038yfwn",
        "tokenRequestorID": "1234567890"
      },
      "cardId": "<string>",
      "status": "ACTIVE",
      "nameOnCard": "John Doe",
      "billingAddress": {
        "country": "USA"
      }
    }
  ]
}