What's new: card limits

What’s new

A new limit type has been introduced: you can now define a daily limit for card payments.

In addition, the CardCreatedOrUpdated webhook is now sent each time a card limit is updated, for both Payment and Withdrawal limits.

Why is this a breaking change?

This feature is not a breaking change.

However, you will now receive a CardCreatedOrUpdated webhook each time a card limit is updated, whereas no notification was sent previously

Impact

New Limit: Daily Period

A new limit with the daily period is now available.

This limit can be defined during the card creation, through:

POST v3.0/cards/physical
POST v3.0/cards/virtual

Please note the attribute is optional,

This limit is returned in:

webhook CardCreatedOrUpdated
GET api/v2.0/cards/cardId/limits

This limit can be modified through:

PUT v2.0/cards/cardId/limits

Here is a summary table of the changes.

Interface agreements

{
  "offerPartnerCode": "DemoClassicPhysicalDebitVISA",
  "cardholderId": "1234-USER",
  "accountId": "1234--ACCOUNT",
  "cardId": "my_card_reference",
  "visualCode": "ABCD",
  "expiryDate": null,
  "limits": [
    {
      "type": "Payment",
      "period": "Daily",
      "value": "3000"
    },
    {
      "type": "Payment",
      "period": "Monthly",
      "value": "3000"
    },
    {
      "type": "Withdrawal",
      "period": "Weekly",
     "value": "3000"
    }
  ]

[
  {
    "type": "Payment",
    "period": "Monthly",
    "limit": {
      "value": "3000.00",
      "currency": "EUR"
    },
    "used": {
      "value": "921.35",
      "currency": "EUR"
    }
  },
  {
    "type": "Payment",
    "period": "Daily",
    "limit": { 
      "value": "25.00",
      "currency": "EUR" },
    "used": { 
      "value": "20.00",
      "currency": "EUR" }
  },
  {
    "type": "Withdrawal",
    "period": "Weekly",
    "limit": {
      "value": "500.00",
      "currency": "EUR"
    },
    "used": {
      "value": "122.00",
      "currency": "EUR"
    }
  }
]

{
  "limits": [
    {
      "type": "Payment",
      "period": "Daily",
      "value": "50"
    },
    {
      "type": "Payment",
      "period": "Monthly",
      "value": "4500"
    },
      {
      "type": "Withdrawal",
      "period": "Weekly",
      "value": "2000"
    },
  ]

{
  "Payload": {
        "type": "CardCreatedOrUpdated",
        "data": {
            "offerPartnerCode": "ClassicPhysicalDebitVISA",
            "cardId": "demoCardId",
            "accountId": "demoAccountId",
            "cardHolderId": "demoCardHolderId",
            "previousCardId": null,
            "panHint": "4900XXXXXXXX0431",
            "status": "Activated",
            "expiryDate": "04-2029",
            "oppositionReasonCode": null,
            "cancellationReasonCode": null,
            "isFrozen": false,
            "hasWishpin": false,
            "isNfcDisabled": false,
            "isInternationalPaymentEnabled": true,
            "isEcomPaymentEnabled": true,
            "deactivationReason": null,
            "batchOrderReference": null,
            "limits": [
                {
                    "type": "Payment",
                    "period": "Monthly",
                    "value": "500"
                },
                {
                    "type": "Payment",
                    "period": "Daily",
                    "value": "50"
                },
                {
                    "type": "Withdrawal",
                    "period": "Weekly",
                    "value": "1500"
                }
            ]
        }
  }
}

Prerequesites

Webhook CardCreatedOrUpdated

Endpoints target card

Additional information

Additional information	Yes/No
Upsell	Yes