# Credit cards ## Get all credit cards Returns all credit cards, possibly filtered by identifiers, [Customers](/connector-api/operations/customers.md#customer) or other filters. Note this operation uses [Pagination](/connector-api/guidelines/pagination.md) and supports [Portfolio Access Tokens](/connector-api/concepts/multi-property.md). ### Request `[PlatformAddress]/api/connector/v1/creditCards/getAll` ```javascript { "ClientToken": "E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D", "AccessToken": "C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D", "Client": "Sample Client 1.0.0", "EnterpriseIds": [ "3fa85f64-5717-4562-b3fc-2c963f66afa6", "4d0201db-36f5-428b-8d11-4f0a65e960cc" ], "CreditCardIds": [ "f1d94a32-b4be-479b-9e47-a9fcb03d5196" ], "CustomerIds": [ "5cbbd97d-5f19-4010-9abf-ab0400a3366a" ], "UpdatedUtc": { "StartUtc": "2023-10-01T00:00:00Z", "EndUtc": "2023-10-31T00:00:00Z" }, "Limitation": { "Count": 10 } } ``` | Property | Type | Contract | Description | | --------------- | -------------------------------------------------------------------- | ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | `ClientToken` | string | required | Token identifying the client application. | | `AccessToken` | string | required | Access token of the client application. | | `Client` | string | required | Name and version of the client application. | | `EnterpriseIds` | array of string | optional, max 1000 items | Unique identifiers of the Enterprises. If not specified, the operation returns data for all enterprises within scope of the Access Token. | | `CreditCardIds` | array of string | optional, max 1000 items | Unique identifiers of the `CreditCard`. Required if no other filter is provided. | | `CustomerIds` | array of string | optional, max 1000 items | Unique identifiers of the `Customer`. | | `UpdatedUtc` | [Time interval](/connector-api/operations/_objects.md#time-interval) | optional, max length 3 months | Interval in which `CreditCard` was updated. | | `Limitation` | [Limitation](/connector-api/guidelines/pagination.md#limitation) | required | Limitation on the quantity of data returned and optional Cursor for the starting point of data. | ### Response ```javascript { "CreditCards": [ { "Id": "f1d94a32-b4be-479b-9e47-a9fcb03d5196", "EnterpriseId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "CreatedUtc": "2023-10-01T11:48:57Z", "UpdatedUtc": "2023-10-28T11:48:57Z", "CustomerId": "a3c90426-43f2-4b53-8482-446dfc724bd2", "Expiration": "2020-11", "Format": "Physical", "IsActive": true, "Kind": "Gateway", "ObfuscatedNumber": "************1111", "State": "Enabled", "Type": "Visa" } ], "Cursor": "f1d94a32-b4be-479b-9e47-a9fcb03d5196" } ``` | Property | Type | Contract | Description | | ------------- | ------------------------------------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `CreditCards` | array of [Credit card](#credit-card) | required | The credit cards. | | `Cursor` | string | optional | Unique identifier of the item one newer in time order than the items to be returned. If Cursor is not specified, i.e. null, then the latest or most recent items will be returned. | #### Credit card | Property | Type | Contract | Description | | ------------------ | ----------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | `Id` | string | required | Unique identifier of the credit card. | | `EnterpriseId` | string | required | Unique identifier of the `Enterprise`. | | `CustomerId` | string | required | Unique identifier of the credit card owner (`Customer`). | | `IsActive` | boolean | required | Whether the credit card is still active. | | `State` | [Credit card state](#credit-card-state) | required | State of the credit card. | | `Kind` | [Credit card kind](#credit-card-kind) | required | Kind of the credit card. | | `Format` | [Credit card format](#credit-card-format) | required | Format of the credit card. | | `Type` | [Credit card type](#credit-card-type) | optional | Type of the credit card. | | `ObfuscatedNumber` | string | optional | Obfuscated credit card number. At most first six digits and last four digits can be specified, otherwise the digits are replaced with `*`. | | `Expiration` | string | optional | Expiration of the credit card in format `MM/YYYY`. | | `CreatedUtc` | string | required | Creation date and time of the credit card in UTC timezone in ISO 8601 format. | | `UpdatedUtc` | string | required | Last update date and time of the credit card in UTC timezone in ISO 8601 format. | #### Credit card state * `Enabled` * `Disabled` #### Credit card kind * `Terminal` * `Gateway` #### Credit card format * `Physical` * `Virtual` #### Credit card type * `MasterCard` * `Visa` * `Amex` * `Discover` * `DinersClub` * `Jcb` * `Maestro` * `UnionPay` * `VPay` * `RuPay` * `Dankort` * `Mir` * `Verve` * `Troy` * `PostFinance` * `Giro` * `Bancomat` * `Bc` * `CarteBleue` * `Eftpos` * `Eps` * `Interac` * `Isracard` * `Meps` * `Nets` * `Bancontact` ## Add tokenized credit card Adds a new tokenized credit card to the specified customer. To be able to use this operation special permission has to be granted during certification. Note this operation supports [Portfolio Access Tokens](/connector-api/concepts/multi-property.md). ### Request `[PlatformAddress]/api/connector/v1/creditCards/addTokenized` ```javascript { "ClientToken": "E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D", "AccessToken": "C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D", "Client": "Sample Client 1.0.0", "CustomerId": "fadd5bb6-b428-45d5-94f8-fd0d89fece6d", "CreditCardData": { "Expiration": "2025-10" }, "EnterpriseId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" } ``` | Property | Type | Contract | Description | | ---------------- | ------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | `ClientToken` | string | required | Token identifying the client application. | | `AccessToken` | string | required | Access token of the client application. | | `Client` | string | required | Name and version of the client application. | | `EnterpriseId` | string | optional | Unique identifier of the enterprise. Required when using [Portfolio Access Tokens](/connector-api/concepts/multi-property.md), ignored otherwise. | | `CustomerId` | string | required | Unique identifier of the `Customer`. | | `CreditCardData` | [Credit card data](#credit-card-data) | required | Credit card details provided by PCI provider. | #### Credit card data | Property | Type | Contract | Description | | ------------- | ------ | -------- | ---------------------------------------------------------------- | | `StorageData` | string | required | Identifier of credit card data in PCI storage (`transactionId`). | | `Expiration` | string | required | Expiration of the credit card in format `yyyy-MM`. | ### Response ```javascript { "CreditCardId": "e417dfe8-c813-4938-837b-36081199ce88" } ``` | Property | Type | Contract | Description | | -------------- | ------ | -------- | -------------------------------------- | | `CreditCardId` | string | required | Unique identifier of the `CreditCard`. | ## Disable gateway credit card > #### Restricted! > > This operation is currently in beta-test and as such it is subject to change. Disable an existing credit card in the system. Only gateway credit cards can be disabled. Note this operation supports [Portfolio Access Tokens](/connector-api/concepts/multi-property.md). ### Request `[PlatformAddress]/api/connector/v1/creditCards/disable` ```javascript { "ClientToken": "E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D", "AccessToken": "C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D", "Client": "Sample Client 1.0.0", "CreditCardId": "f5c6b7a8-9d4f-4e2a-8a3b-2f3b8b9e6a1f", "EnterpriseId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" } ``` | Property | Type | Contract | Description | | -------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | `ClientToken` | string | required | Token identifying the client application. | | `AccessToken` | string | required | Access token of the client application. | | `Client` | string | required | Name and version of the client application. | | `EnterpriseId` | string | optional | Unique identifier of the enterprise. Required when using [Portfolio Access Tokens](/connector-api/concepts/multi-property.md), ignored otherwise. | | `CreditCardId` | string | required | Unique identifier of the `CreditCard` to disable. | ### Response ```javascript {} ``` ## Charge credit card Creates payment for specified customer credit card and charges the credit card via a gateway. Note that the kind of the card has to be `Gateway`. ### Request `[PlatformAddress]/api/connector/v1/creditCards/charge` ```javascript { "ClientToken": "E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D", "AccessToken": "C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D", "Client": "Sample Client 1.0.0", "CreditCardId": "866d3f51-5b8b-4e8f-a3af-5b84768c522d", "Amount": { "GrossValue": 5, "Currency": "EUR" }, "AccountingCategoryId": null, "Notes": null, "ReceiptIdentifier": null } ``` | Property | Type | Contract | Description | | ---------------------- | ---------------------------------------------------------------------------- | -------- | ------------------------------------------------------------ | | `ClientToken` | string | required | Token identifying the client application. | | `AccessToken` | string | required | Access token of the client application. | | `Client` | string | required | Name and version of the client application. | | `CreditCardId` | string | required | Unique identifier of the `CreditCard`. | | `ReceiptIdentifier` | string | optional | Identifier of the payment receipt. | | `AccountingCategoryId` | string | optional | Unique identifier of the `AccountingCategory`. | | `ReservationId` | string | optional | Unique identifier of the reservation the payment belongs to. | | `Amount` | [Amount parameters](/connector-api/operations/_objects.md#amount-parameters) | required | Amount of the credit card payment. | | `Notes` | string | optional | Additional payment notes. | ### Response ```javascript { "PaymentId": "98753f51-5b8b-4e8f-a3af-5b8476865983" } ``` | Property | Type | Contract | Description | | ----------- | ------ | -------- | ---------------------------------------- | | `PaymentId` | string | required | Unique identifier of the `Payment` item. | --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.mews.com/connector-api/operations/creditcards.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.