Update Card by Card ID in C2Pay

Send a request to this endpoint to update Card info. 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.

Billing address restrictions

For Click to Pay card updates, 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.

PUT

click2pay

VISA

update

card

{cardId}

Update Card by Card ID in C2Pay

curl --request PUT \
  --url 'https://integration-api-cat2.{{environment}}.ext.{{realm}}.cia.enfuce.com/wallet/v1/click2pay/VISA/update/card/{cardId}' \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customerBID": "123456",
  "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

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Path Parameters

cardId

string<biginteger>

required

The card id of which card you want to update.

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"

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

Update Card by Card ID in C2Pay

curl --request PUT \
  --url 'https://integration-api-cat2.{{environment}}.ext.{{realm}}.cia.enfuce.com/wallet/v1/click2pay/VISA/update/card/{cardId}' \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customerBID": "123456",
  "cardOverrides": {
    "addressLine1": "1000 Market Street",
    "addressLine2": "Building 56",
    "city": "San Francisco",
    "postalCode": "94105",
    "country": "USA"
  }
}
'

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