Enrol a Cardholder and a Card in C2P

Send a request to this endpoint to enrol a cardholder in Click to Pay and add a card to the account. You may override the cardholder’s email address and phone number, by using the field overrides. If you provide cardOverrides, the billing address fields present in cardOverrides override the corresponding values sent to Visa for this request. Any billing address fields omitted from cardOverrides fall back to the existing stored cardholder data. If cardOverrides is omitted entirely, the existing stored cardholder data is used for all billing address fields. If the request is successful, Visa returns a unique request ID (requestTraceId).

Please note that this endpoint submits data to Visa Click to Pay and some fields, especially the card billing address, are validated according to Visa requirements. These validations may be stricter than Enfuce API validations. For example, billing address lines must not exceed 64 characters, and certain special characters are not allowed. Enfuce does not automatically modify address data before submitting it to Visa, so requests may fail if the provided billing address does not meet Visa’s requirements.

Billing address restrictions

For Click to Pay enrolment, Visa applies the following restrictions to billing address fields:

addressLine1-addressLine3: maximum 64 characters each
city: maximum 32 characters
postalCode: maximum 9 characters
country: 3-character ISO 3166 alpha-3 code when provided
The following characters are not allowed: [, ], {, }, :, &, $, ^, !, =, ;, *, #, backtick, <, >, ", ”
The @ character is not allowed in billing address fields.

POST

/

v1

/

click2pay

/

VISA

/

enroll

/

customer

/

{customerId}

Enrol a Cardholder and a Card in C2P

curl --request POST \
  --url 'https://integration-api-cat2.{{environment}}.ext.{{realm}}.cia.enfuce.com/wallet/v1/click2pay/VISA/enroll/customer/{customerId}' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cardId": [
    "123456789"
  ],
  "customerBID": "123456",
  "overrides": {
    "emails": [
      "alex123@hotmail.com"
    ],
    "phones": [
      "16504005555"
    ]
  },
  "cardOverrides": {
    "addressLine1": "1000 Market Street",
    "addressLine2": "Building 56",
    "city": "San Francisco",
    "postalCode": "94105",
    "country": "USA"
  }
}
'

{
  "requestTraceId": "351562ba-83cf-11ee-b962-0242ac120002"
}

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

Unique identifier of the customer. You have received this via the Customer API.

Query Parameters

auditUser

string

required

The audit user to log the request

Body

application/json

cardId

string[]

required

Unique identifier of the card type you want to enrol in C2P. You have received this via the Card API. Note: If you send multiple card IDs, the request fails and returns an error.

Required array length: 1 element

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"

overrides

object

Customer overrides are used to override the customer information that is stored in the Visa C2P.

Show child attributes

cardOverrides

object

Card overrides are used to provide Visa-compliant billing address fields specifically for the Click to Pay request. Any fields present in cardOverrides override the corresponding billing address values sent to Visa for that request. Any omitted fields fall back to the existing stored cardholder data.

Show child attributes

Example:

{
  "addressLine1": "1000 Market Street",
  "addressLine2": "Building 56",
  "city": "San Francisco",
  "postalCode": "94105",
  "country": "USA"
}

Response

Accepted

requestTraceId

string<uuid>

required

Unique identifier of the request

Required string length: 36

Example:

"351562ba-83cf-11ee-b962-0242ac120002"

⌘I

Enrol a Cardholder and a Card in C2P

curl --request POST \
  --url 'https://integration-api-cat2.{{environment}}.ext.{{realm}}.cia.enfuce.com/wallet/v1/click2pay/VISA/enroll/customer/{customerId}' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cardId": [
    "123456789"
  ],
  "customerBID": "123456",
  "overrides": {
    "emails": [
      "alex123@hotmail.com"
    ],
    "phones": [
      "16504005555"
    ]
  },
  "cardOverrides": {
    "addressLine1": "1000 Market Street",
    "addressLine2": "Building 56",
    "city": "San Francisco",
    "postalCode": "94105",
    "country": "USA"
  }
}
'

{
  "requestTraceId": "351562ba-83cf-11ee-b962-0242ac120002"
}