Reservation management
LSGQL API referenceReservation management

markGuestCreditCardAsInvalid mutation

Reports a traveler’s credit card as invalid, which initiates Expedia’s secure, on-platform recapture process directly with the traveler.

The credit card associated with a reservation can only be marked as invalid once. Multiple recapture attempts are currently not supported and will result in this error: Recapture has already been requested for this reservation. In addition, if the original credit card was marked as invalid by Expedia, the reservation's payment method cannot be marked as invalid by the lodging partner using this mutation.

After this mutation request is received, if successful, Expedia sends an automated email to the traveler, prompting them to update card details through the Virtual Agent. The reservation cannot be cancelled by the property during this recapture window. After the recapture window expires, the reservation becomes eligible for cancellation, or the property can provide more time to the traveler so that they can submit a new credit card. Refer to Reservation update for complete details.

This mutation is not supported for

  • Reservations created with a virtual credit card (VCC)
  • Reservations paid for using ETF direct payments
  • Last-minute reservations created with no credit card
  • Expedia Collect reservations
Note: We recommend that you perform an eligibility check using the reservations query before issuing this mutation to minimize errors that may occur.

Syntax

1mutation {
2 markGuestCreditCardAsInvalid(
5}

Example

1mutation {
2 markGuestCreditCardAsInvalid(
3 input: {
4 clientMutationId: "myPartnerMutationId",
5 propertyId: "923352",
6 reservationId: "123456789",
7 reason: INCORRECT_VERIFICATION_NUMBER
8 }
9 ) {
10 clientMutationId
11 reservationId
12 }
13}

Arguments

NameDescription

input

Required.
Type: MarkGuestCreditCardAsInvalidInput

Types


Name
Type
ID
ID

The ID scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "4") or integer (such as 4) input value will be accepted as an ID.

MarkGuestCreditCardAsInvalidInput
InputObject

Input arguments for the markGuestCreditCardAsInvalid mutation, including the reservation ID and reason.

FieldDescription
clientMutationId

Partner's transaction ID that uniquely identifies the request, which can be used to associate requests and responses for troubleshooting purposes. This ID must be unique across requests and cannot be reused. However, if a request needs to be retried, such as because it failed or timed out, the ID provided in the original request should be used. The ID can be in any format as long as it uniquely identifies the request.

Type: String
propertyIdNot nullable.

Expedia ID of the property associated with the reservation whose credit card must be invalidated.

Type: ID
reasonNot nullable.

Reason for invalidating the credit card.

Type: MarkGuestCreditCardAsInvalidReason
reservationIdNot nullable.

Expedia reservation ID whose credit card must be invalidated.

Type: ID
MarkGuestCreditCardAsInvalidPayload
Object

Response payload for the markGuestCreditCardAsInvalid mutation.

FieldDescription
clientMutationId

Partner's transaction ID that identifies the request, which can be used to correlate with partner's transaction logs. This ID must be unique across requests and cannot be reused.

Type: String
reservationId

Expedia reservation ID whose credit card was invalidated.

Type: ID
MarkGuestCreditCardAsInvalidReason
Enum

Reasons for invalidating a credit card.

NameDescription
INCORRECT_VERIFICATION_NUMBER

CVC/CVV number is incorrect.

NAME_MISMATCH

Name on the credit card does not match the name associated with the reservation.

INSUFFICIENT_FUNDS

Card has insufficient funds to complete the transaction.

EXPIRY_DATE_ISSUE

Expiration year or month is invalid, or the card is expired.

INVALID_NUMBER

Card number is incorrect.

DECLINED_BY_ISSUER

Card was declined by the issuer for an unknown reason.

INVALID_ACCOUNT

Card or account the card is connected to is invalid.

CARD_NETWORK_ISSUE

Card network is not supported by point of sale, or the card issuer could not be reached during authorization.

OTHER

Card failed validation for another reason or for an unknown reason.

String
String

The String scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.