PUT/////
Use this endpoint to update a Visa Alias by its Visa Alias ID.
Header parameter
| Fields | Description |
|---|---|
| req-sys-id string Required | Identifier generated by the card program. These identifiers are used for troubleshooting requests between the card program and Marqeta. Allowable Values: 36 char max |
| participant-id string Required | Visa Business Identifier (BID) that is assigned to the program. Allowable Values: Existing participant ID |
URL path parameters
| Fields | Description |
|---|---|
| aliasId string Required | Unique identifier of the Visa Alias. Allowable Values: Existing Visa Alias ID |
Request body
| Fields | Description |
|---|---|
| consent object Required | Visa Alias Directory Service (ADS) consent information. Allowable Values: presenter, validFromDateTime, version, expiryDateTime, intermediaries |
| consent.presenter string Required | Presenter of the Visa Alias Directory Service (ADS) consent. Allowable Values: 1–120 chars |
| consent.validFromDateTime datetime Required | Date and time when the validity of the Visa ADS consent begins. Allowable Values: 20 chars Format: YYYY-MM-DDThh:mm:ssZ |
| consent.version string Required | Version of the Visa ADS consent. Allowable Values: 1–9 chars |
| consent.expiryDateTime datetime Optional | Date and time when the validity of the Visa ADS consent ends. This field is returned if it exists in the resource. Allowable Values: 20 chars Format: YYYY-MM-DDThh:mm:ssZ |
| consent.intermediaries array of strings Optional | Intermediaries of the Visa ADS consent. Allowable Values: 1–120 chars |
| profile object Required | Alias Directory Service (ADS) profile information. Allowable Values: - firstName- lastName- contactInfo- dateOfBirth- firstNameLocal- lastNameLocal- middleName- middleNameLocal- preferredName |
| profile.firstName string Required | First name in the Alias Directory Service (ADS) profile. Allowable Values: 1–35 chars |
| profile.lastName string Required | Last name in the Alias Directory Service (ADS) profile. Participants in the CEMEA and EU regions must only use the initial of the consumer’s last name followed by a period to create or modify a Visa Alias record. Allowable Values: 1–35 chars |
| profile.contactInfo array of objects Optional | Contact information in the Alias Directory Service (ADS) profile. This array is returned if the Visa Alias’ contact information details exist. Allowable Values: A valid array of contact information details |
| profile.contactInfo[].type string Required | Type of contact information in the Alias Directory Service (ADS) profile. Allowable Values: EMAIL, PHONE, DIRECTORY_ALIASID |
| profile.contactInfo[].value string Required | Contact information value, which is the email address or phone number. Allowable Values: 1–320 chars |
| profile.dateOfBirth string Optional | Date of birth in the Alias Directory Service (ADS) profile. This field is returned if it exists in the resource. Allowable Values: 10 chars |
| profile.firstNameLocal string Optional | First name in the Alias Directory Service (ADS) profile, expressed in the user’s local language. This field is returned if it exists in the resource. Allowable Values: 1–35 chars |
| profile.lastNameLocal string Optional | Last name in the Alias Directory Service (ADS) profile, expressed in the user’s local language. This field is returned if it exists in the resource. Allowable Values: 1–35 chars |
| profile.middleName string Optional | Middle name in the Alias Directory Service (ADS) profile. This field is returned if it exists in the resource. Allowable Values: 1–35 chars |
| profile.middleNameLocal string Optional | Middle name in the Alias Directory Service (ADS) profile, expressed in the user’s local language. This field is returned if it exists in the resource. Allowable Values: 1–35 chars |
| profile.preferredName string Optional | Preferred name in the Alias Directory Service (ADS) profile, as provided by the user. This field is returned if it exists in the resource. Allowable Values: 1–35 chars |
| identification object Optional | Identification of the user associated with the Visa Alias. Allowable Values: type, value, verificationDetails |
| identification.type string Required | Type of identification provided by the user associated with the Visa Alias. Allowable Values: DNI, CE, PASSPORT, PTP, FFPP, FFAA, CCD, COI, PN, CIE, CPF, DL, DPI, NIDN |
| identification.value string Required | Value of the identification provided by the user associated with the Visa Alias, which is used to validate the user. Passport number, for example. Allowable Values: 1–35 chars |
| identification.verificationDetails object Optional | Verification details associated with the Visa Alias. This field is returned if it exists in the resource. Allowable Values: authDateTime, authMethodReference, creationDateTime, verifiedEmail, verifiedPhone |
| identification.verificationDetails.authDateTime datetime Optional | Time when the user provided the credentials for verification in ISO UTC format. Allowable Values: format: YYYY-MM-DDThh:mm:ss.000Z |
| identification.verificationDetails.authMethodReference string Optional | Authentication method used when the user provided the credentials for verification. Allowable Values: 256 char |
| identification.verificationDetails.creationDateTime datetime Optional | Time when the user was created or enrolled in ISO UTC format. Allowable Values: format: YYYY-MM-DDThh:mm:ss.000Z |
| identification.verificationDetails.verifiedEmail boolean Optional | Returns true if an email was verified during the verification process. This email does not need to match the Alias or contact info if an email was used.Allowable Values: true, false |
| identification.verificationDetails.verifiedPhone boolean Optional | Returns true if a phone number was verified during the verification process. This phone number does not need to match the Alias or contact info if a phone number was used.Allowable Values: true, false |
Sample request body
JSON
{
"aliasValue": "1231231234",
"aliasType": "PHONE",
"profile": {
"firstName": "Alex",
"middleName": "Robert",
"lastName": "Miller",
"firstNameLocal": "Alexander",
"middleNameLocal": "Roberto",
"lastNameLocal": "Miller",
"preferredName": "Miller's Shop",
"dateOfBirth": "1980-02-01",
"contactInfo": [
{
"type": "PHONE",
"value": "1231234321"
}
]
},
"consent": {
"version": "1.0",
"presenter": "Bank A",
"validFromDateTime": "2024-12-01T10:00:00Z",
"expiryDateTime": "2025-06-20T10:00:00Z",
"intermediaries": [
"Client A"
]
},
"identification": {
"type": "PASSPORT",
"value": "A123456",
"verificationDetails": {
"authDateTime": "2026-01-01T22:52:46Z",
"verifiedEmail": true,
"verifiedPhone": false,
"creationDateTime": "2026-01-01T22:52:46Z",
"authMethodReference": "EXTERNAL, SMS OTP, Email OTP"
}
},
"createdOn": "2026-01-01T22:52:46Z",
"lastModifiedOn": "2026-01-01T22:52:46Z",
"status": "ACTIVE"
}