Skip to content

Events

This article lists the Webhooks you may receive when issuing Cards.

Cards

card.requestphysical

json
{
  "webhook": "card.requestphysical",
  "object": "card",
  "object_id": "999990081",
  "object_payload": {
    "cards": [
      {
        "cardId": "999990081",
        "userId": "100642533",
        "walletId": "3135941",
        "walletCardtransactionId": "3143087",
        "mccRestrictionGroupId": null,
        "merchantRestrictionGroupId": null,
        "countryRestrictionGroupId": null,
        "eventName": "Main account",
        "eventAlias": "main-account-669697986861c",
        "publicToken": "110662949",
        "cardTag": "",
        "statusCode": "UNLOCK",
        "isLive": "0",
        "pinTryExceeds": "0",
        "maskedPan": "548821******3691",
        "embossedName": "ALEX OAK",
        "expiryDate": "2027-07-31",
        "CVV": "971",
        "startDate": "2024-07-24",
        "endDate": "0000-00-00",
        "countryCode": "FR",
        "currencyCode": "EUR",
        "deliveryTitle": "M",
        "deliveryLastname": "OAK",
        "deliveryFirstname": "ALEX",
        "deliveryAddress1": "07323 cedar hills",
        "deliveryAddress2": "",
        "deliveryAddress3": "",
        "deliveryCity": "PARIS",
        "deliveryPostcode": "75000",
        "deliveryCountry": "FR",
        "mobileSent": "+33123456789",
        "limitsGroup": "TRZ-VL-001",
        "permsGroup": "TRZ-CU-016",
        "cardDesign": "14708",
        "virtualConverted": "0",
        "optionAtm": "1",
        "optionForeign": "1",
        "optionOnline": "1",
        "optionNfc": "1",
        "limitAtmYear": "0",
        "limitAtmMonth": "0",
        "limitAtmWeek": "2000",
        "limitAtmDay": "1000",
        "limitAtmAll": "0",
        "limitPaymentYear": "0",
        "limitPaymentMonth": "0",
        "limitPaymentWeek": "3000",
        "limitPaymentDay": "2000",
        "paymentDailyLimit": "0.00",
        "restrictionGroupLimits": null,
        "limitPaymentAll": "0",
        "totalAtmYear": "0",
        "totalAtmMonth": "0",
        "totalAtmWeek": null,
        "totalAtmDay": null,
        "totalAtmAll": "0",
        "totalPaymentYear": "0",
        "totalPaymentMonth": "0",
        "totalPaymentWeek": null,
        "totalPaymentDay": null,
        "totalPaymentAll": "0",
        "createdBy": "929252",
        "createdDate": "2024-07-18 12:54:28",
        "modifiedBy": "0",
        "modifiedDate": "0000-00-00 00:00:00",
        "cancellationNumber": null,
        "physical": "1"
      }
    ]
  },
  "webhook_created_at": 17213000682093,
  "webhook_id": "056b1e6d-17b3-4796-89e0-653f3cxxxx03",
  "object_payload_signature": "wqGsyqDmHOnkrkyY/mjf+AuWeTlaxhraUxxxxxwMGs="
}

card.createvirtual

json
{
    "webhook": "card.createvirtual",
    "object": "card",
    "object_id": "3xxxxxxx5",
    "object_payload": {
      "cards": [
        {
          "cardId": "99xxxx81",
          "userId": "100xxxxx24",
          "walletId": "2xxx39",
          "walletCardtransactionId": "26xxxx7",
          "mccRestrictionGroupId": null,
          "merchantRestrictionGroupId": null,
          "countryRestrictionGroupId": null,
          "eventName": "test",
          "eventAlias": "test-65c31ec791381",
          "publicToken": "10xxx095",
          "cardTag": "Event-test-card",
          "statusCode": "UNLOCK",
          "isLive": "0",
          "pinTryExceeds": "0",
          "maskedPan": "548821******1520",
          "embossedName": "ALEX OAK",
          "expiryDate": "2027-02-28",
          "CVV": "439",
          "startDate": "2024-02-24",
          "endDate": "0000-00-00",
          "countryCode": "FR",
          "currencyCode": "EUR",
          "deliveryTitle": "MME",
          "deliveryLastname": "OAK",
          "deliveryFirstname": "ALEX",
          "deliveryAddress1": "ROSEWOOK LANE",
          "deliveryAddress2": "",
          "deliveryAddress3": "",
          "deliveryCity": "PARIS",
          "deliveryPostcode": "75000",
          "deliveryCountry": "FR",
          "mobileSent": "+33602030405",
          "limitsGroup": "TRZ-VL-001",
          "permsGroup": "TRZ-CU-012",
          "cardDesign": "8579",
          "virtualConverted": "0",
          "optionAtm": "0",
          "optionForeign": "1",
          "optionOnline": "1",
          "optionNfc": "1",
          "limitAtmYear": "0",
          "limitAtmMonth": "0",
          "limitAtmWeek": "2000",
          "limitAtmDay": "1000",
          "limitAtmAll": "0",
          "limitPaymentYear": "0",
          "limitPaymentMonth": "0",
          "limitPaymentWeek": "3000",
          "limitPaymentDay": "2000",
          "paymentDailyLimit": "500.00",
          "restrictionGroupLimits": null,
          "limitPaymentAll": "0",
          "totalAtmYear": "0",
          "totalAtmMonth": "0",
          "totalAtmWeek": null,
          "totalAtmDay": null,
          "totalAtmAll": "0",
          "totalPaymentYear": "0",
          "totalPaymentMonth": "0",
          "totalPaymentWeek": null,
          "totalPaymentDay": null,
          "totalPaymentAll": "0",
          "createdBy": "9xxxx2",
          "createdDate": "2024-02-16 10:22:30",
          "modifiedBy": "0",
          "modifiedDate": "0000-00-00 00:00:00",
          "cancellationNumber": null,
          "physical": "0"
        }
      ]
    },
    "webhook_created_at": 17080753505931,
    "webhook_id": "9b195a7a-4013-xxxx-b6b1-0f01e3daee26",
    "object_payload_signature": "++++++++++++++++++++++++++++++++++++++++++++="
  }

card.convertvirtual

json
{
    "webhook": "card.convertvirtual",
    "object": "card",
    "object_id": "999840111",
    "object_payload": {
      "cards": [
        {
          "cardId": "999840111",
          "userId": "100150989",
          "walletId": "2677616",
          "walletCardtransactionId": "2678079",
          "mccRestrictionGroupId": null,
          "merchantRestrictionGroupId": null,
          "countryRestrictionGroupId": null,
          "eventName": "Event_test",
          "eventAlias": "event-test-65d48b7545d15",
          "publicToken": "105621111",
          "cardTag": "Event-test-card",
          "statusCode": "UNLOCK",
          "isLive": "0",
          "pinTryExceeds": "0",
          "maskedPan": "548821******7744",
          "embossedName": "ALEX OAK",
          "expiryDate": "2027-02-28",
          "CVV": "727",
          "startDate": "2024-02-24",
          "endDate": "0000-00-00",
          "countryCode": "FR",
          "currencyCode": "EUR",
          "deliveryTitle": "M",
          "deliveryLastname": "OAK",
          "deliveryFirstname": "ALEX",
          "deliveryAddress1": "33 ROSEWOOD LANE",
          "deliveryAddress2": "",
          "deliveryAddress3": "",
          "deliveryCity": "PARIS",
          "deliveryPostcode": "75000",
          "deliveryCountry": "FR",
          "mobileSent": "+33102030405",
          "limitsGroup": "TRZ-VL-001",
          "permsGroup": "TRZ-CU-012",
          "cardDesign": "8579",
          "virtualConverted": "1",
          "optionAtm": "0",
          "optionForeign": "1",
          "optionOnline": "1",
          "optionNfc": "1",
          "limitAtmYear": "0",
          "limitAtmMonth": "0",
          "limitAtmWeek": "2000",
          "limitAtmDay": "1000",
          "limitAtmAll": "0",
          "limitPaymentYear": "0",
          "limitPaymentMonth": "0",
          "limitPaymentWeek": "3000",
          "limitPaymentDay": "2000",
          "paymentDailyLimit": "500.00",
          "restrictionGroupLimits": null,
          "limitPaymentAll": "0",
          "totalAtmYear": "0",
          "totalAtmMonth": "0",
          "totalAtmWeek": null,
          "totalAtmDay": null,
          "totalAtmAll": "0",
          "totalPaymentYear": "0",
          "totalPaymentMonth": "0",
          "totalPaymentWeek": null,
          "totalPaymentDay": null,
          "totalPaymentAll": "0",
          "createdBy": "929252",
          "createdDate": "2024-02-20 15:13:11",
          "modifiedBy": "929252",
          "modifiedDate": "2024-02-20 15:13:30",
          "cancellationNumber": null,
          "physical": "0"
        }
      ]
    },
    "webhook_created_at": 17084384103167,
    "webhook_id": "320b618d-9bcc-419e-9324-6365d3c52bfa",
    "object_payload_signature": "++++++++++++++++++++++++++++++++++++++++++++="
  }

card.changepin

json
{
    "webhook": "card.changepin",
    "object": "card",
    "object_id": "333840683",
    "object_payload": {
      "cards": [
        {
          "cardId": "333840683",
          "userId": "100150383",
          "walletId": "2677616",
          "walletCardtransactionId": "2678073",
          "mccRestrictionGroupId": null,
          "merchantRestrictionGroupId": null,
          "countryRestrictionGroupId": null,
          "eventName": "Event_test",
          "eventAlias": "event-test-65d48b7545d15",
          "publicToken": "105623117",
          "cardTag": "Event-test-card",
          "statusCode": "UNLOCK",
          "isLive": "1",
          "pinTryExceeds": "0",
          "maskedPan": "548821******7744",
          "embossedName": "ALEX OAK",
          "expiryDate": "2027-02-28",
          "CVV": "727",
          "startDate": "2024-02-24",
          "endDate": "0000-00-00",
          "countryCode": "FR",
          "currencyCode": "EUR",
          "deliveryTitle": "M",
          "deliveryLastname": "OAK",
          "deliveryFirstname": "ALEX",
          "deliveryAddress1": "33 ROSEWOOD LANE",
          "deliveryAddress2": "",
          "deliveryAddress3": "",
          "deliveryCity": "PARIS",
          "deliveryPostcode": "75000",
          "deliveryCountry": "FR",
          "mobileSent": "+33102030405",
          "limitsGroup": "TRZ-VL-001",
          "permsGroup": "TRZ-CU-012",
          "cardDesign": "8523",
          "virtualConverted": "1",
          "optionAtm": "0",
          "optionForeign": "1",
          "optionOnline": "1",
          "optionNfc": "1",
          "limitAtmYear": "0",
          "limitAtmMonth": "0",
          "limitAtmWeek": "2000",
          "limitAtmDay": "1000",
          "limitAtmAll": "0",
          "limitPaymentYear": "0",
          "limitPaymentMonth": "0",
          "limitPaymentWeek": "3000",
          "limitPaymentDay": "2000",
          "paymentDailyLimit": "500.00",
          "restrictionGroupLimits": null,
          "limitPaymentAll": "0",
          "totalAtmYear": "0",
          "totalAtmMonth": "0",
          "totalAtmWeek": null,
          "totalAtmDay": null,
          "totalAtmAll": "0",
          "totalPaymentYear": "0",
          "totalPaymentMonth": "0",
          "totalPaymentWeek": null,
          "totalPaymentDay": null,
          "totalPaymentAll": "0",
          "createdBy": "323252",
          "createdDate": "2024-02-20 15:13:11",
          "modifiedBy": "323252",
          "modifiedDate": "2024-02-20 15:24:33",
          "cancellationNumber": null,
          "physical": "0"
        }
      ]
    },
    "webhook_created_at": 17084330737405,
    "webhook_id": "32bc6ef1-c703-4000-3a8f-b7b662741cf6",
    "object_payload_signature": "++++++++++++++++++++++++++++++++++++++++++++="
  }

card.activate

json
{
    "webhook": "card.activate",
    "object": "card",
    "object_id": "999840683",
    "object_payload": {
      "cards": [
        {
          "cardId": "999840683",
          "userId": "100150989",
          "walletId": "2677616",
          "walletCardtransactionId": "2678079",
          "mccRestrictionGroupId": null,
          "merchantRestrictionGroupId": null,
          "countryRestrictionGroupId": null,
          "eventName": "Event_test",
          "eventAlias": "event-test-65d48b7545d15",
          "publicToken": "105623117",
          "cardTag": "Event-test-card",
          "statusCode": "UNLOCK",
          "isLive": "1",
          "pinTryExceeds": "0",
          "maskedPan": "548821******7744",
          "embossedName": "ALEX OAK",
          "expiryDate": "2027-02-28",
          "CVV": "727",
          "startDate": "2024-02-24",
          "endDate": "0000-00-00",
          "countryCode": "FR",
          "currencyCode": "EUR",
          "deliveryTitle": "M",
          "deliveryLastname": "OAK",
          "deliveryFirstname": "ALEX",
          "deliveryAddress1": "33 ROSEWOOD LANE",
          "deliveryAddress2": "",
          "deliveryAddress3": "",
          "deliveryCity": "PARIS",
          "deliveryPostcode": "75000",
          "deliveryCountry": "FR",
          "mobileSent": "+33102030405",
          "limitsGroup": "TRZ-VL-001",
          "permsGroup": "TRZ-CU-012",
          "cardDesign": "8529",
          "virtualConverted": "1",
          "optionAtm": "0",
          "optionForeign": "1",
          "optionOnline": "1",
          "optionNfc": "1",
          "limitAtmYear": "0",
          "limitAtmMonth": "0",
          "limitAtmWeek": "2000",
          "limitAtmDay": "1000",
          "limitAtmAll": "0",
          "limitPaymentYear": "0",
          "limitPaymentMonth": "0",
          "limitPaymentWeek": "3000",
          "limitPaymentDay": "2000",
          "paymentDailyLimit": "500.00",
          "restrictionGroupLimits": null,
          "limitPaymentAll": "0",
          "totalAtmYear": "0",
          "totalAtmMonth": "0",
          "totalAtmWeek": null,
          "totalAtmDay": null,
          "totalAtmAll": "0",
          "totalPaymentYear": "0",
          "totalPaymentMonth": "0",
          "totalPaymentWeek": null,
          "totalPaymentDay": null,
          "totalPaymentAll": "0",
          "createdBy": "929252",
          "createdDate": "2024-02-20 15:13:11",
          "modifiedBy": "929252",
          "modifiedDate": "2024-02-20 15:16:57",
          "cancellationNumber": null,
          "physical": "0"
        }
      ]
    },
    "webhook_created_at": 17084386172700,
    "webhook_id": "fab6773d-fe05-4f59-a258-a5e42695d6xx",
    "object_payload_signature": "++++++++++++++++++++++++++++++++++++++++++++="
  }

card.renew

json
{
	"webhook": "card.renew",
	"webhook_id": "2xxxxxx8",
	"object": "card",
	"object_id": "6xxx6",
	"object_payload": {
		"cards": [
			{
			"cardId": "100003123",
			"userId": "3075987",
			"walletId": "3397876",
			"walletCardtransactionId": "123456",
			"mccRestrictionGroupId": null,
			"merchantRestrictionGroupId": null,
			"countryRestrictionGroupId": null,
			"eventName": "Wallet",
			"eventAlias": "xxxxxx-wallet-5fe1208c2d47e",
			"publicToken": "332945545",
			"cardTag": "d42d0082-7bac-47be-b219-2975aed12345",
			"statusCode": "UNLOCK",
			"isLive": "0",
			"pinTryExceeds": "0",
			"maskedPan": "123456******1234",
			"embossedName": "Alex Oak",
			"expiryDate": "2026-12-31",
			"CVV": "123",
			"startDate": "2020-12-20",
			"endDate": "0000-00-00",
			"countryCode": "FR",
			"currencyCode": "EUR",
			"deliveryTitle": "M",
			"deliveryLastname": "ALEX",
			"deliveryFirstname": "OAK",
			"deliveryAddress1": "12 Rosewood Road",
			"deliveryAddress2": "",
			"deliveryAddress3": "",
			"deliveryCity": "PARIS",
			"deliveryPostcode": "75000",
			"deliveryCountry": "FRA",
			"mobileSent": "0033333333333",
			"limitsGroup": "TRZ-VL-001",
			"permsGroup": "TRZ-CU-015",
			"cardDesign": "5996",
			"virtualConverted": "1",
			"optionAtm": "1",
			"optionForeign": "0",
			"optionOnline": "1",
			"optionNfc": "1",
			"limitAtmYear": "0",
			"limitAtmMonth": "1000",
			"limitAtmWeek": "300",
			"limitAtmDay": "1000",
			"limitAtmAll": "0",
			"limitPaymentYear": "0",
			"limitPaymentMonth": "1600",
			"limitPaymentWeek": "1000",
			"limitPaymentDay": "2000",
			"paymentDailyLimit": "0.00",
			"restrictionGroupLimits": null,
			"limitPaymentAll": "0",
			"totalAtmYear": "0",
			"totalAtmMonth": null,
			"totalAtmWeek": null,
			"totalAtmDay": null,
			"totalAtmAll": "0",
			"totalPaymentYear": "0",
			"totalPaymentMonth": null,
			"totalPaymentWeek": null,
			"totalPaymentDay": null,
			"totalPaymentAll": "0",
			"createdBy": "372837",
			"createdDate": "2023-12-18 00:00:00",
			"modifiedBy": "0",
			"modifiedDate": "0000-00-00 00:00:00",
			"cancellationNumber": null,
			"physical": "0"
			}
		]
	},
	"object_payload_signature": "o4tf+JC0PbJ1t9kjg2PRr2xE7xh3Am/12345678abcA="
}

card.update

json
{
  "webhook": "card.update",
  "object": "card",
  "object_id": "999925786",
  "object_payload": {
    "cards": [
      {
        "cardId": "999925786",
        "userId": "100549108",
        "walletId": "3011794",
        "walletCardtransactionId": "3012053",
        "mccRestrictionGroupId": "48203",
        "merchantRestrictionGroupId": "107454",
        "countryRestrictionGroupId": "183120",
        "eventName": "Main account",
        "eventAlias": "main-account-6670280a28c2c",
        "publicToken": "105618829",
        "cardTag": "Updated cardTag",
        "statusCode": "UNLOCK",
        "isLive": "1",
        "pinTryExceeds": "0",
        "maskedPan": "548821******0226",
        "embossedName": "ALEX OAK",
        "expiryDate": "2024-06-18",
        "CVV": "740",
        "startDate": "2024-06-24",
        "endDate": "2024-06-17",
        "countryCode": "FR",
        "currencyCode": "EUR",
        "deliveryTitle": "M",
        "deliveryLastname": "OAK",
        "deliveryFirstname": "ALEX",
        "deliveryAddress1": "30217 CRUICKSHANK SPRINGS",
        "deliveryAddress2": "",
        "deliveryAddress3": "",
        "deliveryCity": "VERSAILLES",
        "deliveryPostcode": "78000",
        "deliveryCountry": "FR",
        "mobileSent": "+33141358530",
        "limitsGroup": "TRZ-VL-001",
        "permsGroup": "TRZ-CU-016",
        "cardDesign": "8529",
        "virtualConverted": "1",
        "optionAtm": "1",
        "optionForeign": "1",
        "optionOnline": "1",
        "optionNfc": "1",
        "limitAtmYear": "2000",
        "limitAtmMonth": "2000",
        "limitAtmWeek": "2000",
        "limitAtmDay": "1000",
        "limitAtmAll": "0",
        "limitPaymentYear": "5000",
        "limitPaymentMonth": "0",
        "limitPaymentWeek": "3000",
        "limitPaymentDay": "2000",
        "paymentDailyLimit": "500.00",
        "restrictionGroupLimits": null,
        "limitPaymentAll": "0",
        "totalAtmYear": null,
        "totalAtmMonth": null,
        "totalAtmWeek": null,
        "totalAtmDay": null,
        "totalAtmAll": "0",
        "totalPaymentYear": "0.00",
        "totalPaymentMonth": "0",
        "totalPaymentWeek": null,
        "totalPaymentDay": null,
        "totalPaymentAll": "0",
        "createdBy": "929252",
        "createdDate": "2024-06-17 14:43:54",
        "modifiedBy": "929252",
        "modifiedDate": "2024-07-18 14:07:33",
        "cancellationNumber": null,
        "physical": "0"
      }
    ]
  },
  "webhook_created_at": 17213044534278,
  "webhook_id": "6b0aee69-87c8-45df-a0d9-42xxxx9f38b",
  "object_payload_signature": "WTFf7nbDnCoT6EVMRaTTTSHkA87BxxxxxdPCU30Usmo="
}

card.limits

json
{
  "webhook": "card.limits",
  "object": "card",
  "object_id": "999990082",
  "object_payload": {
    "cards": [
      {
        "cardId": "999990082",
        "userId": "100642533",
        "walletId": "3135941",
        "walletCardtransactionId": "3143122",
        "mccRestrictionGroupId": null,
        "merchantRestrictionGroupId": null,
        "countryRestrictionGroupId": null,
        "eventName": "Main account",
        "eventAlias": "main-account-669697986861c",
        "publicToken": "105603885",
        "cardTag": "sky blue",
        "statusCode": "UNLOCK",
        "isLive": "1",
        "pinTryExceeds": "0",
        "maskedPan": "548821******6470",
        "embossedName": "ALEX OAK",
        "expiryDate": "2027-07-31",
        "CVV": "582",
        "startDate": "2024-07-24",
        "endDate": "0000-00-00",
        "countryCode": "FR",
        "currencyCode": "EUR",
        "deliveryTitle": "M",
        "deliveryLastname": "OAK",
        "deliveryFirstname": "ALEX",
        "deliveryAddress1": "07323 SIPES SHOALS",
        "deliveryAddress2": "",
        "deliveryAddress3": "",
        "deliveryCity": "PARIS",
        "deliveryPostcode": "75017",
        "deliveryCountry": "FR",
        "mobileSent": "+33141358530",
        "limitsGroup": "TRZ-VL-001",
        "permsGroup": "TRZ-CU-012",
        "cardDesign": "8529",
        "virtualConverted": "0",
        "optionAtm": "0",
        "optionForeign": "1",
        "optionOnline": "1",
        "optionNfc": "1",
        "limitAtmYear": "2000",
        "limitAtmMonth": "2000",
        "limitAtmWeek": "2000",
        "limitAtmDay": "1000",
        "limitAtmAll": "0",
        "limitPaymentYear": "5000",
        "limitPaymentMonth": "0",
        "limitPaymentWeek": "3000",
        "limitPaymentDay": "2000",
        "paymentDailyLimit": "500.00",
        "restrictionGroupLimits": null,
        "limitPaymentAll": "0",
        "totalAtmYear": null,
        "totalAtmMonth": null,
        "totalAtmWeek": null,
        "totalAtmDay": null,
        "totalAtmAll": "0",
        "totalPaymentYear": null,
        "totalPaymentMonth": "0",
        "totalPaymentWeek": null,
        "totalPaymentDay": null,
        "totalPaymentAll": "0",
        "createdBy": "929252",
        "createdDate": "2024-07-18 14:10:51",
        "modifiedBy": "929252",
        "modifiedDate": "2024-07-18 14:10:57",
        "cancellationNumber": null,
        "physical": "0"
      }
    ]
  },
  "webhook_created_at": 17213046655230,
  "webhook_id": "09cc975d-d9f8-4a61-a85d-c027022xx9e5",
  "object_payload_signature": "zXK+EMoIk88fQ4xxxxxJaMhS9RPDteRAifLZxF8fd8="
}

card.options

json
{
  "webhook": "card.options",
  "object": "card",
  "object_id": "999990082",
  "object_payload": {
    "cards": [
      {
        "cardId": "999990082",
        "userId": "100642533",
        "walletId": "3135941",
        "walletCardtransactionId": "3143122",
        "mccRestrictionGroupId": null,
        "merchantRestrictionGroupId": null,
        "countryRestrictionGroupId": null,
        "eventName": "Main account",
        "eventAlias": "name-of-the-wallet-669697986861c",
        "publicToken": "105603885",
        "cardTag": "sky blue",
        "statusCode": "UNLOCK",
        "isLive": "1",
        "pinTryExceeds": "0",
        "maskedPan": "548821******6470",
        "embossedName": "ALEX OAK",
        "expiryDate": "2027-07-31",
        "CVV": "582",
        "startDate": "2024-07-24",
        "endDate": "0000-00-00",
        "countryCode": "FR",
        "currencyCode": "EUR",
        "deliveryTitle": "M",
        "deliveryLastname": "OAK",
        "deliveryFirstname": "ALEX",
        "deliveryAddress1": "07323 SIPES SHOALS",
        "deliveryAddress2": "",
        "deliveryAddress3": "",
        "deliveryCity": "PARIS",
        "deliveryPostcode": "75017",
        "deliveryCountry": "FR",
        "mobileSent": "+33141358530",
        "limitsGroup": "TRZ-VL-001",
        "permsGroup": "TRZ-CU-016",
        "cardDesign": "8529",
        "virtualConverted": "0",
        "optionAtm": "1",
        "optionForeign": "1",
        "optionOnline": "1",
        "optionNfc": "1",
        "limitAtmYear": "2000",
        "limitAtmMonth": "2000",
        "limitAtmWeek": "2000",
        "limitAtmDay": "1000",
        "limitAtmAll": "0",
        "limitPaymentYear": "5000",
        "limitPaymentMonth": "0",
        "limitPaymentWeek": "3000",
        "limitPaymentDay": "2000",
        "paymentDailyLimit": "500.00",
        "restrictionGroupLimits": null,
        "limitPaymentAll": "0",
        "totalAtmYear": null,
        "totalAtmMonth": null,
        "totalAtmWeek": null,
        "totalAtmDay": null,
        "totalAtmAll": "0",
        "totalPaymentYear": null,
        "totalPaymentMonth": "0",
        "totalPaymentWeek": null,
        "totalPaymentDay": null,
        "totalPaymentAll": "0",
        "createdBy": "929252",
        "createdDate": "2024-07-18 14:10:51",
        "modifiedBy": "929252",
        "modifiedDate": "2024-07-18 14:13:03",
        "cancellationNumber": null,
        "physical": "0"
      }
    ]
  },
  "webhook_created_at": 17213047836871,
  "webhook_id": "54517817-3ec9-4c65-8f56-0a9xxb2e68c",
  "object_payload_signature": "6/pvFUoCdhyrhidvC2j+YihNZF9E0exxxxpEiDu72E="
}

card.setpin

json
{
    "webhook": "card.setpin",
    "object": "card",
    "object_id": "333840683",
    "object_payload": {
      "cards": [
        {
          "cardId": "333840683",
          "userId": "100150383",
          "walletId": "2677616",
          "walletCardtransactionId": "2678073",
          "mccRestrictionGroupId": null,
          "merchantRestrictionGroupId": null,
          "countryRestrictionGroupId": null,
          "eventName": "Event_test",
          "eventAlias": "event-test-65d48b7545d15",
          "publicToken": "105623117",
          "cardTag": "Event-test-card",
          "statusCode": "UNLOCK",
          "isLive": "1",
          "pinTryExceeds": "0",
          "maskedPan": "548821******7744",
          "embossedName": "ALEX OAK",
          "expiryDate": "2027-02-28",
          "CVV": "727",
          "startDate": "2024-02-24",
          "endDate": "0000-00-00",
          "countryCode": "FR",
          "currencyCode": "EUR",
          "deliveryTitle": "M",
          "deliveryLastname": "OAK",
          "deliveryFirstname": "ALEX",
          "deliveryAddress1": "33 ROSEWOOD LANE",
          "deliveryAddress2": "",
          "deliveryAddress3": "",
          "deliveryCity": "PARIS",
          "deliveryPostcode": "75000",
          "deliveryCountry": "FR",
          "mobileSent": "+33102030405",
          "limitsGroup": "TRZ-VL-001",
          "permsGroup": "TRZ-CU-012",
          "cardDesign": "8523",
          "virtualConverted": "1",
          "optionAtm": "0",
          "optionForeign": "1",
          "optionOnline": "1",
          "optionNfc": "1",
          "limitAtmYear": "0",
          "limitAtmMonth": "0",
          "limitAtmWeek": "2000",
          "limitAtmDay": "1000",
          "limitAtmAll": "0",
          "limitPaymentYear": "0",
          "limitPaymentMonth": "0",
          "limitPaymentWeek": "3000",
          "limitPaymentDay": "2000",
          "paymentDailyLimit": "500.00",
          "restrictionGroupLimits": null,
          "limitPaymentAll": "0",
          "totalAtmYear": "0",
          "totalAtmMonth": "0",
          "totalAtmWeek": null,
          "totalAtmDay": null,
          "totalAtmAll": "0",
          "totalPaymentYear": "0",
          "totalPaymentMonth": "0",
          "totalPaymentWeek": null,
          "totalPaymentDay": null,
          "totalPaymentAll": "0",
          "createdBy": "323252",
          "createdDate": "2024-02-20 15:13:11",
          "modifiedBy": "323252",
          "modifiedDate": "2024-02-20 15:21:17",
          "cancellationNumber": null,
          "physical": "0"
        }
      ]
    },
    "webhook_created_at": 17084388772481,
    "webhook_id": "2d53e374-0385-438d-a661-13533c03d0f7",
    "object_payload_signature": "++++++++++++++++++++++++++++++++++++++++++++="
  }

card.unblockpin

json
{
	"webhook": "card.unblockpin",
	"webhook_id": "2xxxxxx0",
	"object": "card",
	"object_id": "6xxx3",
	"object_payload": {
		"cards": [
		{
			"cardId": "6xxx3",
			"userId": "1xxxxx3",
			"walletId": "8xxxx5",
			"walletCardtransactionId": "8xxxx2",
			"pinTryExceeds": "0",
			// [...] some attributes are hidden
		}
		]
	},
	"object_payload_signature": "LnYAh2rE9DMTbDqjkM/p5Ks05cck85Vk8j05xfvLGBc="
}

card.lockunlock

json
{
  "webhook": "card.lockunlock",
  "object": "card",
  "object_id": "999988610",
  "object_payload": {
    "cards": [
      {
        "cardId": "999988610",
        "userId": "100640138",
        "walletId": "3137125",
        "walletCardtransactionId": "3137126",
        "mccRestrictionGroupId": null,
        "merchantRestrictionGroupId": null,
        "countryRestrictionGroupId": null,
        "eventName": "Main account",
        "eventAlias": "main-account-669754fea40f1",
        "publicToken": "105592812",
        "cardTag": "",
        "statusCode": "LOCK",
        "isLive": "1",
        "pinTryExceeds": "0",
        "maskedPan": "548821******2232",
        "embossedName": "ALEX OAK",
        "expiryDate": "2027-07-31",
        "CVV": "790",
        "startDate": "2024-07-24",
        "endDate": "0000-00-00",
        "countryCode": "FR",
        "currencyCode": "EUR",
        "deliveryTitle": "M",
        "deliveryLastname": "ALEX",
        "deliveryFirstname": "OAK",
        "deliveryAddress1": "TES23 cedar hills",
        "deliveryAddress2": "",
        "deliveryAddress3": "",
        "deliveryCity": "PARIS",
        "deliveryPostcode": "75000",
        "deliveryCountry": "FR",
        "mobileSent": "+33612345678",
        "limitsGroup": "TRZ-VL-001",
        "permsGroup": "TRZ-CU-015",
        "cardDesign": "8529",
        "virtualConverted": "0",
        "optionAtm": "1",
        "optionForeign": "0",
        "optionOnline": "1",
        "optionNfc": "1",
        "limitAtmYear": "2000",
        "limitAtmMonth": "2000",
        "limitAtmWeek": "1000",
        "limitAtmDay": "500",
        "limitAtmAll": "5000",
        "limitPaymentYear": "10000",
        "limitPaymentMonth": "5000",
        "limitPaymentWeek": "3000",
        "limitPaymentDay": "1000",
        "paymentDailyLimit": "2000.00",
        "restrictionGroupLimits": [
          {
            "merchantIdRestrictionGroups": 94748,
            "paymentDailyLimit": 0.01
          }
        ],
        "limitPaymentAll": "30000",
        "totalAtmYear": null,
        "totalAtmMonth": null,
        "totalAtmWeek": null,
        "totalAtmDay": null,
        "totalAtmAll": null,
        "totalPaymentYear": null,
        "totalPaymentMonth": null,
        "totalPaymentWeek": null,
        "totalPaymentDay": null,
        "totalPaymentAll": null,
        "createdBy": "929252",
        "createdDate": "2024-07-17 07:22:08",
        "modifiedBy": "929252",
        "modifiedDate": "2024-07-18 13:15:21",
        "cancellationNumber": null,
        "physical": "0"
      }
    ]
  },
  "webhook_created_at": 17213013210351,
  "webhook_id": "755c4496-ad53-4a29-9d27-2d9xxxx5b0f",
  "object_payload_signature": "5hPGRs+h6eF+Un2VIUJ/V5KFlN4CxxxcjmDHxh0gLQU="
}

card.regenerate

json
{
	"webhook": "card.regenerate",
	"webhook_id": "2xxxxxx4",
	"object": "card",
	"object_id": "6xxx6",
	"object_payload": {
	"cards": [
		{
		"cardId": "6xxx6",
		"userId": "1xxxxx3",
		"walletId": "8xxxx5",
		"walletCardtransactionId": "8xxxx3",
		"expiryDate": "2024-04-30",
		"CVV": "724",
		"physical": "0"
		// [...] some attributes are hidden
		}
	]
	},
	"object_payload_signature": "aAd1gmssgfKiyWZ16njB/b/rk0qQ0NL19CSwOLXLhvY="
}

card.register3DS

json
{
  "webhook": "card.register3DS",
  "object": "card",
  "object_id": "9999886XX",
  "object_payload": {
    "cards": [
      {
        "cardId": "999988610",
        "userId": "100640138",
        "walletId": "3137125",
        "walletCardtransactionId": "3137126",
        "mccRestrictionGroupId": null,
        "merchantRestrictionGroupId": null,
        "countryRestrictionGroupId": null,
        "eventName": "Main account",
        "eventAlias": "main-account-669754fea40f1",
        "publicToken": "105511111",
        "cardTag": "",
        "statusCode": "UNLOCK",
        "isLive": "1",
        "pinTryExceeds": "0",
        "maskedPan": "548821******2232",
        "embossedName": "ALEX OAK",
        "expiryDate": "2027-07-31",
        "CVV": "790",
        "startDate": "2024-07-24",
        "endDate": "0000-00-00",
        "countryCode": "FR",
        "currencyCode": "EUR",
        "deliveryTitle": "M",
        "deliveryLastname": "ALEX",
        "deliveryFirstname": "OAK",
        "deliveryAddress1": "15 rosewood lane",
        "deliveryAddress2": "",
        "deliveryAddress3": "",
        "deliveryCity": "PARIS",
        "deliveryPostcode": "75000",
        "deliveryCountry": "FR",
        "mobileSent": "+33612345678",
        "limitsGroup": "TRZ-VL-001",
        "permsGroup": "TRZ-CU-015",
        "cardDesign": "8529",
        "virtualConverted": "0",
        "optionAtm": "1",
        "optionForeign": "0",
        "optionOnline": "1",
        "optionNfc": "1",
        "limitAtmYear": "2000",
        "limitAtmMonth": "2000",
        "limitAtmWeek": "1000",
        "limitAtmDay": "500",
        "limitAtmAll": "5000",
        "limitPaymentYear": "10000",
        "limitPaymentMonth": "5000",
        "limitPaymentWeek": "3000",
        "limitPaymentDay": "1000",
        "paymentDailyLimit": "2000.00",
        "restrictionGroupLimits": "[{\"merchantIdRestrictionGroups\":94748,\"paymentDailyLimit\":0.01}]",
        "limitPaymentAll": "30000",
        "totalAtmYear": null,
        "totalAtmMonth": null,
        "totalAtmWeek": null,
        "totalAtmDay": null,
        "totalAtmAll": null,
        "totalPaymentYear": null,
        "totalPaymentMonth": null,
        "totalPaymentWeek": null,
        "totalPaymentDay": null,
        "totalPaymentAll": null,
        "createdBy": "929252",
        "createdDate": "2024-07-17 07:22:08",
        "modifiedBy": "929252",
        "modifiedDate": "2024-07-17 07:22:09",
        "cancellationNumber": null,
        "physical": "0"
      }
    ]
  },
  "webhook_created_at": 17212967948092,
  "webhook_id": "7a4796f4-5ca7-478a-b5fd-3d5831xxxxxx",
  "object_payload_signature": "QpoPfubfnsDYCVT+iEzxxxxxAvTm7h13ieDLY5UvIA="
}

card.expiryAlert

You receive this webhook a month before the expiry date of an active or temporarily blocked card (i.e., statusCode is either UNLOCK or LOCK). For example, for an active card expiring on July 31st 2024, Treezor sends a card.expiryAlert webhook on June 1st 2024.

json
{
  "webhook": "card.expiryAlert",
  "object_payload": {
      "cards": [
          {
              "cardId": "2111143",
              "expiryDate": "YYYY-MM-DD",
              "renewalType": "A",
              "userId": "1234",
              "publicToken": "111111682",
              "maskedPan": "545923****21321",
              "cardDesign": "555",
              "designCode": "01",
              "cardTag": "custom",
              "isLive": "1",
              "statusCode": "UNLOCK",
              "physical": "1"
          }
      ]
  },
  "object_id": "2312343",
  "object": "card",
  "webhook_created_at": 17251498098864,
  "webhook_id": "4e4fad5b-78b5-4d7a-a8ac-bed3xxxxd66a",
  "object_payload_signature": "DSzhfXH4CJjCCdx5ducs/WB3vqADAvGwxxxxx6VbNz0="
}

card.expeditionTracking Beta

You receive this webhook when the card manufacturer mails the physical card (if the corresponding feature is activated).

json
{
	"webhook": "card.expeditionTracking",
	"object": "card",
	"object_id": "reconciliation_id",
	"object_payload": {
		"publicToken": "1234",
		"deliveryDate": "2024-07-17 07:22:09",
		"deliveryMethod": "",
		"batchDeliveryId": 0,
		"trackingNumber": 0,
		"requestType": "CREATION",  // CREATION (new cards) or RENEWAL (replacement)
	},
	"object_payload_signature": "++++++++++++++++++++++++++++++++++++++++++++"
}

Card Digitalization

cardDigitalization.request production-only

Webhook TAR.

json
{
	"webhook": "cardDigitalization.request",
	"object": "cardDigitalization",
	"object_id": "11",							
	"object_payload": {
		"deviceType": "PHONE", 					// PaymentToken_deviceType
		"deviceName": "", 
		"tokenRequestor": "APPLE", 				// can also be "GOOGLE", "SAMSUNG", "MerchToken"
		"tokenServiceProvider": "Visa", 		
		"cardDigitizationExternalId": "21498",
        "tokenizationDecision": "ACCEPTED",		// can also be "DECLINED",
        "reasonDecision": "",					// empty in case of "ACCEPTED", populated in case of a "DECLINED"
		"cardId": 6127,
		"correlationId":"" 
	},
	"object_payload_signature": "++++++++++++++++++++++++++++++++++++++++++++"
}

cardDigitalization.update production-only

json
{
	"webhook": "cardDigitalization.update",
	"object": "cardDigitalization",
	"object_id": "11",
	"object_payload": {
		"id":123,
		"cardId": 32134,
		"status":"S",
		"createdDate":"2022-10-19 15:12:50",
		"modifiedDate":"2022-10-24 15:44:30",
		"tokenServiceProvider": "Visa",
		"updateType":""
	},
	"object_payload_signature": "++++++++++++++++++++++++++++++++++++++++++++"
}

cardDigitalization.activation production-only

Webhook ACN.

json
{
	"webhook": " cardDigitalization.activation ",
	"webhook_id": "3788548",
	"object": " cardDigitalization ",
	"object_id": "11",
	"object_payload": {
		"deviceType": "UNDEFINED",
		"deviceName": "",
		"tokenRequestor": "APPLE",
		"tokenServiceProvider": "Visa",
		"cardDigitizationExternalId": "21498",
		"activationCode": "123456",
		"activationCodeExpiry": "Dec 31 2016 11:11AM",
		"activationMethod": "EMAIL_TO_CARDHOLDER_ADDRESS",
		"cardId": 6127
	},
	"object_payload_signature": "++++++++++++++++++++++++++++++++++++++++++++"
}

cardDigitalization.complete production-only

Webhook TCN.

json
{
	"webhook": " cardDigitalization.complete",
	"webhook_id": "3788546",
	"object": " cardDigitalization ",
	"object_id": "11",
	"object_payload": {
		"deviceType": "",
		"deviceName": "",
		"tokenRequestor": "APPLE",
		"tokenServiceProvider": "Visa", 
		"cardDigitalizationExternalId": "21498",
		"cardId": 6127,
		"tokenId": "48 Chars ANS - Token Unique Reference",
		"merchantRequestorName": "",// up to 40 chars. identifies the M4M merchant requestor
		"correlationId" : 4815162342
	},
	"object_payload_signature": "++++++++++++++++++++++++++++++++++++++++++++"
}

cardDigitalization.deactivated production-only

json
{
    "messageId": "7e233828-a947-5fcd-8d27-xxxxxxxxxxxxxx",
    "webhookId": "2b562cd5-b1ef-4962-8109-xxxxxxxxxxxxxx",
    "webhook": {
        "webhook": "cardDigitalization.deactivated",
        "object": "cardDigitalization",
        "object_id": "2773123",
        "object_payload": {
            "cardDigitalizations": [
                {
                    "id": 2773123,
                    "cardId": 5390123,
                    "status": "X",
                    "createdDate": "2024-02-05 16:22:20",
                    "modifiedDate": "2024-02-15 11:49:17"
                }
            ]
        },
        "webhook_created_at": 17079941571098,
        "webhook_id": "2b562cd5-b1ef-4962-8109-xxxxxxxxxxxxxx",
        "object_payload_signature": "++++++++++++++++++++++++++++++++++++++++++++"
    }
}

MID Group

merchantIdGroup.create

json
{
	"webhook": "merchantIdGroup.create",
	"webhook_id": "2xxxxx9",
	"object": "merchantIdGroup",
	"object_id": "4xx1",
	"object_payload": {
		"merchantIdRestrictionGroups": [
		{
			"id": 4xx1,
			"name": "Merchant Test",
			"isWhitelist": true,
			"status": "VALIDATED",
			"startDate": "2017-12-19 16:03:55",
			"createdDate": "2021-04-20 16:11:10",
			"modifiedDate": null
		}
		]
	},
	"object_payload_signature": "K5hea0NO9hBVwIenmZBlvV1ay85XxKWFzgvS5mRH2tI="
}

merchantIdGroup.update

json
{
	"webhook": "merchantIdGroup.update",
	"webhook_id": "2xxxxxx5",
	"object": "merchantIdGroup",
	"object_id": "4xx3",
	"object_payload": {
		"merchantIdRestrictionGroups": [
		{
			"id": 4xx3,
			"name": "Merchant Test",
			"isWhitelist": true,
			"status": "VALIDATED",
			"startDate": "2017-12-19 16:03:55",
			"createdDate": "2021-04-20 16:30:22",
			"modifiedDate": "2021-04-21 10:02:39"
		}
		]
	},
	"object_payload_signature": "k46KsOCHLNXf0mc+S3+DAp71UMmHIAr00GxKxpLDL8E="
}

merchantIdGroup.cancel

json
{
	"webhook": "merchantIdGroup.cancel",
	"webhook_id": "2xxxxxx7",
	"object": "merchantIdGroup",
	"object_id": "4xx5",
	"object_payload": {
		"merchantIdRestrictionGroups": [
		{
			"id": 4xx5,
			"name": "Merchant Test",
			"isWhitelist": true,
			"status": "CANCELED",
			"startDate": "2017-12-19 16:03:55",
			"createdDate": "2021-04-21 08:03:05",
			"modifiedDate": "2021-04-21 08:30:45"
		}
		]
	},
	"object_payload_signature": "NDakNFLjBVpl+b3skAfg1EO+B+SGRe81ZVpV0cYlVqk="
}

MCC Group

mccGroup.create

json
{
	"webhook": "mccGroup.create",
	"webhook_id": "2xxxxxx8",
	"object": "mccGroup",
	"object_id": "5xx4",
	"object_payload": {
		"mccRestrictionGroups": [
		{
			"id": 5xx4,
			"name": "MCC Group Test",
			"isWhitelist": true,
			"mcc": [
			8911,
			763
			],
			"status": "VALIDATED",
			"startDate": "2017-11-01 10:00:00",
			"createdDate": "2021-04-20 15:47:26",
			"modifiedDate": null
		}
		]
	},
	"object_payload_signature": "Swx2bnNeYo0gKO+LaD1+lw6sS+ue2M7+sI5HAc6U5fU="
}

mccGroup.update

json
{
	"webhook": "mccGroup.update",
	"webhook_id": "2xxxxxx2",
	"object": "mccGroup",
	"object_id": "5xx4",
	"object_payload": {
		"mccRestrictionGroups": [
		{
			"id": 5xx4,
			"name": "MCC Group Test",
			"isWhitelist": true,
			"mcc": [
			8911,
			763
			],
			"status": "VALIDATED",
			"startDate": "2017-11-01 10:00:00",
			"createdDate": "2021-04-20 15:47:26",
			"modifiedDate": "2021-04-20 15:58:37"
		}
		]
	},
	"object_payload_signature": "L0AsXqQAEzVPITCWgXVbBd7QVeqS0VED+7Cks6JL68g="
}

mccGroup.cancel

json
{
	"webhook": "mccGroup.cancel",
	"webhook_id": "2xxxxxx9",
	"object": "mccGroup",
	"object_id": "5xx4",
	"object_payload": {
		"mccRestrictionGroups": [
		{
			"id": 5xx4,
			"name": "MCC Group Test",
			"isWhitelist": true,
			"mcc": [
			8911,
			763
			],
			"status": "CANCELED",
			"startDate": "2017-11-01 10:00:00",
			"createdDate": "2021-04-20 15:47:26",
			"modifiedDate": "2021-04-20 16:00:44"
		}
		]
	},
	"object_payload_signature": "A8/on0tyGHkPWnoRzUCIH9nahq/H1HRt1iwHehTbRjo="
}

Country Group

countryGroup.create

json
{
	"webhook": "countryGroup.create",
	"webhook_id": "2xxxxx8",
	"object": "countryGroup",
	"object_id": "2xx8",
	"object_payload": {
		"countryRestrictionGroups": [
		{
			"id": 2xx8,
			"name": "Test Country Group",
			"isWhitelist": true,
			"countries": [
			"250"
			],
			"status": "VALIDATED",
			"startDate": "2021-04-20 00:00:00",
			"createdDate": "2021-04-20 13:48:49",
			"modifiedDate": null
		}
		]
	},
	"object_payload_signature": "KHlM6UudrM/t6IHlQMUO0fxklueJJrpOt66HE/+6Pns="
}

countryGroup.update

json
{
	"webhook": "countryGroup.update",
	"webhook_id": "2xxxxx3",
	"object": "countryGroup",
	"object_id": "2xx9",
	"object_payload": {
		"countryRestrictionGroups": [
		{
			"id": 2xx9,
			"name": "Test Country Group",
			"isWhitelist": true,
			"countries": [
			"250"
			],
			"status": "VALIDATED",
			"startDate": "2021-04-20 00:00:00",
			"createdDate": "2021-04-20 13:52:04",
			"modifiedDate": "2021-04-20 13:57:29"
		}
		]
	},
	"object_payload_signature": "pmVAqdJUlbreSgYth9fkq2WhOKM8wrTQxF6HM6bpGLQ="
}

countryGroup.cancel

json
{
	"webhook": "countryGroup.cancel",
	"webhook_id": "2xxxxx5",
	"object": "countryGroup",
	"object_id": "2xx9",
	"object_payload": {
		"countryRestrictionGroups": [
		{
			"id": 2xx9,
			"name": "Test Country Group",
			"isWhitelist": true,
			"countries": [
			"250"
			],
			"status": "CANCELED",
			"startDate": "2021-04-20 00:00:00",
			"createdDate": "2021-04-20 13:52:04",
			"modifiedDate": "2021-04-20 14:08:30"
		}
		]
	},
	"object_payload_signature": "CDsjDd4QcEd9Kig8hzOuJuUZP/yWnRMl3MZTcgZxwg8="
}