Credit cards

Get all credit cards

Returns all credit cards, possibly filtered by identifiers, Customers or other filters. Note this operation uses Pagination and supports Portfolio Access Tokens.

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	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	optional, max length 3 months	Interval in which CreditCard was updated.
Limitation	Limitation	required	Limitation on the quantity of data returned and optional Cursor for the starting point of data.

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	array of 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	required	State of the credit card.
Kind	Credit card kind	required	Kind of the credit card.
Format	Credit card format	required	Format of the 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.

Request

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

{
  "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, ignored otherwise.
CustomerId	string	required	Unique identifier of the Customer.
CreditCardData	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

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

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	Unique identifier of the enterprise. Required when using Portfolio Access Tokens, ignored otherwise.
CreditCardId	string	required	Unique identifier of the CreditCard to disable.

Response

{}

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	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	required	Amount of the credit card payment.
Notes	string	optional	Additional payment notes.

Response

{
  "PaymentId": "98753f51-5b8b-4e8f-a3af-5b8476865983"
}

Property	Type	Contract	Description
PaymentId	string	required	Unique identifier of the Payment item.