Connector API
  • Mews Connector API
  • Getting started
  • Usage guidelines
    • Authentication
    • Requests
    • Responses
    • Environments
    • Serialization
    • Pagination
    • Best practices
  • Concepts
    • Multi-property
    • Restrictions
    • Taxation
    • Time units
  • Use cases
    • 'How to' use cases
    • Accounting
    • Customer loyalty
    • Customer management
    • Customer messaging
    • Data export
    • Device integration
    • Events
    • Guest technology
    • Housekeeping
    • Kiosk
    • Mews Payment Terminals
    • Payment automation
    • Point of sale
    • Reputation management
    • Revenue management
    • Upsell
  • API Operations
    • Common objects
    • Accounting categories
    • Accounting items
    • Accounts
    • Account notes
    • Addresses
    • Age categories
    • Availability adjustments
    • Availability blocks
    • Bills
    • Business segments
    • Cancellation policies
    • Cashiers
    • Cashier transactions
    • Commands
    • Companies
    • Companionships
    • Company contracts
    • Configuration
    • Counters
    • Countries
    • Credit cards
    • Currencies
    • Customers
    • Departments
    • Devices
    • Enterprises
    • Exchange rates
    • Exports
    • Identity documents
    • Images
    • Languages
    • Loyalty memberships
    • Loyalty programs
    • Loyalty tiers
    • Messages
    • Message threads
    • Order items
    • Orders
    • Outlet bills
    • Outlet items
    • Outlets
    • Payments
    • Payment requests
    • Preauthorizations
    • Product categories
    • Product service orders
    • Products
    • Rates
    • Rate groups
    • Reservations
    • Reservation groups
    • Resource access tokens
    • Resource blocks
    • Resources
    • Resource categories
    • Resource features
    • Restrictions
    • Routing rules
    • Rules
    • Service order notes
    • Service overbooking limits
    • Services
    • Source assignments
    • Sources
    • Tasks
    • Tax environments
    • Taxations
    • Vouchers
    • Voucher codes
  • API Events
    • Ways to communicate
    • General Webhooks
    • Integration Webhooks
    • Webhooks FAQ
    • WebSockets
  • Your integration journey
    • Certification
  • Deprecations
    • Migration guide: Get all reservations
  • Changelog
    • Changelog 2024
    • Changelog 2023
    • Changelog 2022
    • Changelog 2021
    • Changelog 2020
    • Changelog 2019
    • Changelog 2018
    • Changelog 2017
    • Changelog 2016
Powered by GitBook
On this page
  • Get all credit cards
  • Request
  • Response
  • Charge credit card
  • Request
  • Response
  • Add tokenized credit card
  • Request
  • Response
  • Disable gateway credit card
  • Request
  • Response

Was this helpful?

  1. API Operations

Credit cards

PreviousCountriesNextCurrencies

Last updated 1 month ago

Was this helpful?

Get all credit cards

Returns all credit cards, possibly filtered by identifiers, or other filters. Note this operation uses and supports .

Request

[PlatformAddress]/api/connector/v1/creditCards/getAll

{
    "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

CreditCardIds

array of string

optional, max 1000 items

CustomerIds

array of string

optional, max 1000 items

UpdatedUtc

optional, max length 3 months

Limitation

required

Limitation on the quantity of data returned.

Response

{
    "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

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

CustomerId

string

required

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.

Expiration

string

optional

Expiration of the credit card in format MM/YYYY.

IsActive

boolean

required

Whether the credit card is still active.

ObfuscatedNumber

string

optinal

Obfuscated credit card number. At most first six digits and last four digits can be specified, otherwise the digits are replaced with *.

Format

required

Format of the credit card.

Kind

required

Kind of the credit card.

State

required

State of the credit card.

Type

required

Type of the credit card.

Credit card format

  • Physical

  • Virtual

Credit card kind

  • Terminal

  • Gateway

Credit card state

  • Enabled

  • Disabled

Credit card type

  • MasterCard, Visa, Amex, Maestro, Discover, VPay, ...

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

{
    "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

ReservationId

string

optional

Unique identifier of the reservation the payment belongs to.

Amount

required

Amount of the credit card payment.

AccountingCategoryId

string

optional

ReceiptIdentifier

string

optional

Identifier of the payment receipt.

Notes

string

optional

Additional payment notes.

Response

{
    "PaymentId": "98753f51-5b8b-4e8f-a3af-5b8476865983"
}
Property
Type
Contract
Description

PaymentId

string

required

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.

Request

[PlatformAddress]/api/connector/v1/creditCards/addTokenized

{
    "ClientToken": "E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D",
    "AccessToken": "C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D",
    "Client": "Sample Client 1.0.0",
    "CustomerId": "e98995b0-140a-4208-bbeb-b77f2c43d6ee",
    "CreditCardData": {
        "StorageData": "190510170631533875",
        "Expiration": "2025-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.

CustomerId

string

required

CreditCardData

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

{
    "CreditCardId": "ee2209ce-71c6-4e3a-978f-aac700c82c7b"
}
Property
Type
Contract
Description

CreditCardId

string

required

Disable gateway credit card

Restricted!

This operation is currently in beta-test and as such it is subject to change.

Request

[PlatformAddress]/api/connector/v1/creditCards/disable

{
  "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

CreditCardId

string

required

Unique identifier of the CreditCard to disable.

Response

{}

Unique identifiers of the . If not specified, the operation returns data for all enterprises within scope of the Access Token.

Unique identifiers of the . Required if no other filter is provided.

Unique identifiers of the .

Interval in which was updated.

array of

Unique identifier of the .

Unique identifier of the credit card .

string

string

string

string

Unique identifier of the .

Unique identifier of the .

Unique identifier of the .

Unique identifier of the .

Unique identifier of the .

Disable an existing credit card in the system. Only gateway credit cards can be disabled. Note this operation supports .

Unique identifier of the enterprise. Required when using , ignored otherwise.

Portfolio Access Tokens
Portfolio Access Tokens
Credit cards
Credit card
Credit cards
Credit card format
Credit card kind
Credit card state
Credit card type
Credit card
Credit card data
Credit card
Pagination
Portfolio Access Tokens
Limitation
Accounting category
Time interval
Customers
Customers
owner
Customer
Amount value
Payment item
Enterprises
Enterprise