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 }
}
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 Credit cards. Required if no other filter is provided.
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"
}
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
Id
string
required
Unique identifier of the credit card.
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 *
.
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
}
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.
ReservationId
string
optional
Unique identifier of the reservation the payment belongs to.
ReceiptIdentifier
string
optional
Identifier of the payment receipt.
Notes
string
optional
Additional payment notes.
Response
{
"PaymentId": "98753f51-5b8b-4e8f-a3af-5b8476865983"
}
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"
}
}
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.
Credit card data
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"
}
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"
}
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
{}
Last updated
Was this helpful?