Card

Credit cards are one of the main entities for Pliant. The most important things to know about Pliant credit cards are

• the different cardConfigs, which determine the type of the card and how it looks
• the limits on those cards and how often they renew
• the status of the card and
• optional cardControls, to block or allow certain merchants for instanceModel

Card Object

Below you find all card fields grouped into meaningful categories.

1. Identification & Ownership

2. Card Details

3. Issuance & Validity

4. Limits & Balances

5. Tokenization & Network Metadata

6. Design & Presentation

7. Controls, Flags & Behavior

8. Teams & Projects

9. Replacement Lifecycle

Card Configs / Types

The cardConfig is the full configuration of a card in Pliants platform. It entails for example the VISA type of the card, whether it is physical or virtual and also how the card is displayed or printed.

Please note, that not all listed card configurations might be available to you. It depends on the setup of the organization and partnership. To get the real-time view on available card configurations, please consult the endpoint for listing all available cardConfigs for a given organization.

📘

Note regarding physical cards

Each member can only have one single physical card at the same time (per organization account). Before activating a second physical card, the first one has to be terminated. This means the total number of physical cards that can be issued for your organization matches its total number of members.

PLIANT_BLUE

A physical VISA Platinum Business credit card, including global acceptance and high limits to facilitate any purchase.

PLIANT_BLACK

A physical VISA Infinite Business credit card, including the features of the VISA Platinum Business cards plus world-class travel insurance, unlimited worldwide airport lounge access and exclusive offers from selected partners.

PLIANT_VIRTUAL

A virtual VISA Platinum Business credit card with global acceptance and high limits to facilitate any purchase. Similar to the physical one, just virtual and available immediately without any shipping.

PLIANT_SINGLE_USE

A virtual single-use VISA Platinum Business credit card with the same feature set as the virtual card. This card can be used exactly for one purchase. Card-checks are not counted towards the limit of one purchase and also refunds are possible up to 3 months after the card issuing date.

PLIANT_VIRTUAL_TRAVEL

A virtual VISA Platinum Business credit card for travel use cases. These cards are exempted from 3DS for a smooth automated API usage. Merchant-based card controls can be set up for these cards, just like with other cards.

Only available after separate activation and depending on the account group the organization is in! You can always check available card configurations via the endpoint.

PLIANT_VIRTUAL_TRAVEL_CC_***

A virtual Visa Commercial Choice Travel credit card for travel use cases. For Travel industry customers and depending on your commercial agreement, Pliant can also provide you with Visa Commercial Choice Travel cards, providing a wider range of interchange levels selectable by the customer. Please get in touch with your Pliant representative in case you require further details.

The *** have to be replaced with the desired interchange level bps (basis points) for the card. Valid card configurations are as follows.

• PLIANT_VIRTUAL_TRAVEL_CC_100
• PLIANT_VIRTUAL_TRAVEL_CC_120
• PLIANT_VIRTUAL_TRAVEL_CC_150
• PLIANT_VIRTUAL_TRAVEL_CC_180
• PLIANT_VIRTUAL_TRAVEL_CC_200
• PLIANT_VIRTUAL_TRAVEL_CC (which defaults to 200 bps)

Only available after separate activation and depending on the account group the organization is in! You can always check available card configurations via the endpoint.

Card Status

• PENDING_REGISTRATION - A virtual card was issued for a cardholder who has not completed cardholder registration yet.
• PENDING_ISSUANCE - Intermediate status between PENDING_REGISTRATION and PENDING_ACTIVATION/ACTIVE. If issuing fails, card remains in this status.
• PENDING_ACTIVATION - A physical card is issued, but the cardholder has not activated it yet.
• REQUESTED - The card has been requested, but is not yet approved or rejected.
• REQUEST_CANCELLED - The card request was cancelled by the cardholder.
• REQUEST_APPROVED - The card request has been approved by an admin.
• REQUEST_REJECTED - The card request was rejected by an admin.
• ACTIVE - The card is active.
• LOCKED - The card is locked, this can have several reasons, e.g. due to date/time card controls.
• LOCKED_PIN - The PIN for a physical card was entered incorrectly for 3 times.
• EXPIRED - The card is expired.
• TERMINATED - The card was terminated.
• TERMINATED_LOST - The card was terminated, because it was lost.
• TERMINATED_STOLEN - The card was terminated, because it was stolen.

Changing card limits and card limit frequencies

When changing the limit or the limitRenewFrequency of a card, you might wonder how this affects the availableBalance of the card. Here is the calculation we do:

• when thelimit of a card is updated, then: availableLimit = newLimit + balance. Where the balance is the current account balance calculated as the sum of transactions within the limit renew period (between the resets, i.e. month, quarter, year, total).
• when thelimitRenewFrequency of a card is updated, then we first recalculate the balance as a sum of transactions in the new limit renew period and then use the previous formula: availableLimit = newLimit + balance.

Note that the balance here will be mostly negative. Purchases are negative and refunds are positive. And since this is a credit card, purchases will be the majority of transactions on a card.

Platform Fee Cards

The platformFee refers to a card designed to handle fee-related transactions, such as platform fees or foreign exchange (FX) fees.

Important note: if you notice platform fee cards and their corresponding card check transactions (through relevant API calls or in the Pliant dashboard), we suggest to hide them from the end customer unless actual fees have been charged.

You can find more about those cards here.

Example Data

{
  "cardId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "organizationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "cardholderId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "type": "VIRTUAL",
  "status": "ACTIVE",
  "label": "my credit card",
  "purpose": null,
  "refNum": "1234",
  "issuingDate": "2023-02-27T10:38:24.801Z",
  "expiryDate": "2023-02-27T10:38:24.801Z",
  "limit": {
    "value": 10000,
    "currency": "EUR"
  },
  "spendingBalance": {
    "value": 0,
    "currency": "EUR"
  },
  "availableBalance": {
    "value": 10000,
    "currency": "EUR"
  },
  "transactionLimit": {
    "value": 5000,
    "currency": "EUR"
  },
  "token": "123456",
  "cardDesign": "PLIANT_VIRTUAL_RED",
  "productRef": "PRD_REF",
  "platformFee": false,
  "limitPeriodEnd": "2023-02-27T10:38:24.801Z",
  "limitRenewDate": "2023-02-27",
  "limitRenewFrequency": "MONTHLY",
  "cardConfig": "ADALOVELACE_VIRTUAL"
}

State Machine

Card Copilot

The Card Copilot feature allows organizations to grant full access to travel purchasing cards to users other than the original cardholder. Copilots can view card details, manage settings, and make transactions with the same privileges as the primary cardholder.

In brief:

• The feature is available only for travel purchasing cards
• It must be activated by an owner/admin via the Modules page
• All activities are tracked in audit logs

How It Works

1. Activate the Card Copilot module via the Modules page in the app
2. Specify the copilots value when calling any Issue Card endpoint
   1. You can specify cardholderIds and/or teamIds

If the above points are completed no further steps are required and the feature can be used.

Additionally you can:

• Update the copilot(s) of a specific card via the Update Card Copilots endpoint

or

• Specify a new cardholder for a set card via the Claim Card As Copilot endpoint
  • This works for users that are already copilots for the card
  • It allows you to transfer ownership of a card (e.g.: in the event of a cardholder leaving a company)

More information on how the feature works from the app perspective available in our Help Center. (login required)

Important Remarks

Replacing an existing card

• For physical cards, you can provide a reason:
  • if LOST, STOLEN the current card gets automatically terminated,
  • if EXPIRING_SOON, DAMAGED or DAMAGED the current card gets terminated when the new one is activated. Additionally, EXPIRING_SOON can only be used if the card expires within the next three months.
  • Physical cards are being replaced automatically shortly before they expire.
• For virtual cards, you can provide STOLEN (for compromised card details) or OTHER. In both cases, the replaced card gets immediately terminated.
• A replacement of a card is only possible if the card is not in one of the following statuses: PENDING_ISSUANCE, PENDING_REGISTRATION, REQUESTED. Also, single-use cards cannot be replaced at all.