Getting the credit card status

GET https://payments-api.booking.com/connectivity-payments/reservations/{reservationId}/status?type=ccstatus

When the credit card status is either INVALID_CARD or INITIAL_CARD_CHECK_UNSUCCESSFUL, you receive a notification. Upon receiving the CREDIT_CARD_STATUS_UPDATE notification, you can query the endpoint to get the current card status. Based on the status, you can take the appropriate action, such as requesting the guest to update the card or cancel the reservation.

For more information, see Card verification flow.

The following table describes what elements you must add as path parameters:

The following table describes what elements you must add as query parameters:

The following is a successful response body example:

{
    "meta": {
        "ruid": "ekjdb-vi1je-fv723b-jewklnnn"
    },
    "data": {
        "reservation_id": "res123",
        "status_type": "CREDIT_CARD_VALIDATION",
        "status_value": "INVALID_CARD"
    },
    "errors": [],
    "warnings": []
}

The following is an error response body example:

{
  "meta": {
    "ruid": "ekjdb-vi1je-fv723b-jewklnnn"
  },
  "data": null,
  "errors": [
    {
      "description": "The reservation is not on Smart Pay at Property",
      "message": "BAD_REQUEST",
      "status_code": 400,
      "debug_message": null
    }
  ],
  "warnings": []
}

The following table describes the response elements:

The only two statuses for which a notification is sent are INITIAL_CARD_CHECK_UNSUCCESSFUL and INVALID_CARD.

This table lists and describes the response codes that the Credit Card Status API can return.