Promote Secondary Card to Primary

PUT 
/client/users/:correlation_id/card/:loyalty_id/promote

• This call promotes a Secondary card to the Primary card of the account. The previous Primary card is kept with status ACTIVE.

• The correlation ID used with the Start Session call will be used to identify the account.

• The card number is sent as a path parameter is the Secondary card to be promoted.

• The card number to be promoted must be from the same account as the Primary card.

• It's not possible to promote a secondary card to primary if the account status is CLOSED or DECEASED.

Request

Body

There is no Body for this request.

Response

Attribute	Definition	Format	Notes
message	Provides message about success of process.	String	If successful: "Card promoted successfully."

Error Responses

statusMessage	errorMessage	errorCode	Definition
400 Bad Request	LoyaltyId specified is already the primary card for this account.	INVALID_REQUEST	The card selected to make the primary is already the primary card.
400 Bad Request	LoyaltyId specified is not associated with this Account.	INVALID_REQUEST	The LoyaltyId used is not valid for this account. Use the correct LoyaltyId.
400 Bad Request	Cannot promte card for this account.	INVALID_REQUEST	The card selected cannot be promoted for this account (unspecified reason).
401 Unauthorized	Account status is CLOSED.	API_VALIDATION	Cannot promote card for an account that is CLOSED.

Request

Responses

200

200 - Promoted Secondary Card to Primary

400

400 - Card is Already the Primary Card

401

401 - Account Status is Closed

Response Headers

Content-Length
Example: 39
Connection
Example: keep-alive
Date
Example: Thu, 29 Sep 2022 14:43:05 GMT
x-amzn-RequestId
Example: 30ba166d-da0e-4d92-b570-054040ec06c2
Referrer-Policy
Example: no-referrer
X-XSS-Protection
Example: 1;mode=block
Access-Control-Allow-Origin
Example: *
MCK-APPID
Example: ES-CS-V1
MCK-MSGID
Example: mck-920b9070-8b11-47d5-a26a-641a81e84737
Expect-CT
Example: max-age=86400
Strict-Transport-Security
Example: max-age=31536000; includeSubDomains; preload
Feature-Policy
Example: vibrate 'none'; geolocation 'none'
X-Frame-Options
Example: sameorigin
Content-Security-Policy
Example: connect-src 'none';object-src https://*.cloudfront.net;script-src https://*.cloudfront.net
MCK-MSGTIMESTAMP
Example: September 29th 2022, 2:43:04
x-amz-apigw-id
Example: ZOhGxEnsIAMFpJg=
Cache-Control
Example: no-cache, no-store, must-revalidate
MCK_CORRELATIONID
Example: CORRELATION_ID_NOT_PROVIDED_IN_REQUEST
X-Content-Type-Options
Example: nosniff
X-Amzn-Trace-Id
Example: Root=1-6335aef7-5dcacca052d1282852cc708e;Sampled=0
X-Cache
Example: Miss from cloudfront
Via
Example: 1.1 fff6a70a81914898c2756daea39344e8.cloudfront.net (CloudFront)
X-Amz-Cf-Pop
Example: IAD79-C2
X-Amz-Cf-Id
Example: vSUeUi6yzsps0TIwLEJ0wE3aCHaTGa1Kzz-eKFCk380BFTjext7d9Q==