POST////
Use this endpoint to enroll a new card for an existing cardholder in Click to Pay for Visa.
For more information about this ecommerce checkout solution, see Click to Pay.
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 |
| external-consumer-id-owner-bid string Required | Visa Business Identifier (BID) of the entity to which an External Consumer ID belongs. Allowable Values: 1–8 chars |
Request body
| Fields | Description |
|---|---|
| card object Required | Card information for Visa Click to Pay. Allowable Values: cardToken, nameOnCard |
| card.cardToken string Required | Unique identifier of the card. Allowable Values: 1–36 chars |
| card.nameOnCard string Required | Name of the cardholder that appears on the card. Allowable Values: 1–120 chars |
| card.billingAddress object Required | Billing address for Visa Click to Pay. Allowable Values: address1, city, state, country, postalCode |
| card.billingAddress.address1 string Optional | First line of the billing address. Allowable Values: 1–64 chars |
| card.billingAddress.address2 string Optional | Optional second line of the billing address. Allowable Values: 1–64 chars |
| card.billingAddress.city string Optional | City of the billing address. Allowable Values: 1–32 chars |
| card.billingAddress.state string Optional | State of the billing address. Allowable Values: 1–3 chars |
| card.billingAddress.country string Required | Country of the billing address. Allowable Values: 3 chars |
| card.billingAddress.postalCode string Optional | Postal code of the billing address. Allowable Values: 1–9 chars |
| userToken string Required | Unique identifier of the cardholder. Allowable Values: 1–36 chars |
Sample request body
JSON
{
"userToken": "1234567890",
"card": {
"cardToken": "2345678901",
"nameOnCard": "John Smith",
"billingAddress": {
"address1": "123 Elm Street",
"address2": "APT 1",
"city": "Oakland",
"state": "CA",
"country": "USA",
"postalCode": "94607"
}
}
}
Response body
| Fields | Description |
|---|---|
| requestTraceId string Returned | Unique identifier of the Visa Click to Pay request. Allowable Values: 1–36 chars |
Sample response body
JSON
{
"requestTraceId": "2b6f0cc904d137be2e1730235f5664094b83"
}