Outgoing cardholder event webhook endpoint
This is not an endpoint. This is the description of a request that is sent to subscribed webhooks upon cardholder creation or update.
Download OpenAPI specification
Body
Cardholder event
Enfuce generated unique identifier of the cardholder.
"20218aae-b15e-406c-9e9f-23735cd86a48"
External unique identifier of the cardholder, set by the issuer. Can contain both letters and numbers. Max character limit is 36.
1 - 36^[A-Za-z0-9-]+$"ABCDEFGH123456789"
Cardholder's language and country code in RFC 5646 format.
af-ZA, ar-AE, ar-BH, ar-DZ, ar-EG, ar-IQ, ar-JO, ar-KW, ar-LB, ar-LY, ar-MA, ar-OM, ar-QA, ar-SA, ar-SY, ar-TN, ar-YE, az-AZ, be-BY, bg-BG, bn-IN, bs-BA, ca-ES, cs-CZ, cy-GB, da-DK, de-AT, de-CH, de-DE, de-LI, de-NL, el-GR, en-AU, en-BZ, en-CA, en-GB, en-IE, en-JM, en-MT, en-NZ, en-PH, en-TT, en-US, en-VI, en-ZA, en-ZW, es-AR, es-BO, es-CL, es-CO, es-CR, es-DO, es-EC, es-ES, es-GT, es-HN, es-MX, es-NI, es-PA, es-PE, es-PR, es-PY, es-SV, es-UY, es-VE, et-EE, eu-ES, fa-IR, fi-FI, fo-FO, fr-BE, fr-CA, fr-CH, fr-FR, fr-MC, fr-NL, ga-IE, gl-ES, gu-IN, he-IL, hi-IN, hr-HR, hu-HU, hy-AM, id-ID, is-IS, it-CH, it-IT, ja-JP, ka-GE, kk-KZ, kl-GL, kn-IN, ko-KR, kok-IN, lt-LT, lv-LV, mk-MK, ml-IN, mn-MN, mr-IN, ms-BN, ms-MY, mt-MT, nb-NO, nl-BE, nl-NL, nn-NO, no-NO, pa-IN, pl-PL, pt-BR, pt-PT, ro-RO, ru-RU, se-NO, sk-SK, sl-SI, sq-AL, sr-BA, sr-CS, sv-FI, sv-SE, sw-KE, syr-SY, ta-IN, te-IN, th-TH, tn-ZA, tr-TR, uk-UA, uz-UZ, vi-VN, xh-ZA, zh-CN, zh-HK, zh-MO, zh-SG, zh-TW, zu-ZA "en-GB"
Mobile number of the cardholder — it must be a full number, including the country code and starting with +.
([+]){1}([1-9]){1}([0-9]){5,14}"+358401234567"
First name of the cardholder. Max character limit is 256.
1 - 256^(?!\s)(?!.*\s$)(?! *$)[A-Za-z0-9 ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖØÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõöøùúûüý þÿĀāĂ㥹ĆćĈĉĊċČčĎďĐđĒēĔĕĖėĘęĚěĜĝĞğĠġĢģĤĥĦħĨĩĪīĬĭĮįİıIJijĴĵĶķĸĹ ĺĻļĽľĿŀŁłŃńŅņŇňʼnŊŋŌōŎŏŐőŒœŔŕŖŗŘřŚśŜŝŞşŠšŢţŤťŦŧŨũŪūŬŭŮůŰűŲųŴŵ ŶŷŸŹźŻżŽžſǪǫȘșȚțȪȫȮȯȲȳḐḑṢṣẞỌọ'\-]+$"John"
Middle name of the cardholder. Max character limit is 256.
1 - 256^(?!\s)(?!.*\s$)(?! *$)[A-Za-z0-9 ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖØÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõöøùúûüý þÿĀāĂ㥹ĆćĈĉĊċČčĎďĐđĒēĔĕĖėĘęĚěĜĝĞğĠġĢģĤĥĦħĨĩĪīĬĭĮįİıIJijĴĵĶķĸĹ ĺĻļĽľĿŀŁłŃńŅņŇňʼnŊŋŌōŎŏŐőŒœŔŕŖŗŘřŚśŜŝŞşŠšŢţŤťŦŧŨũŪūŬŭŮůŰűŲųŴŵ ŶŷŸŹźŻżŽžſǪǫȘșȚțȪȫȮȯȲȳḐḑṢṣẞỌọ'\-]+$"James"
Last name of the cardholder. Max character limit is 256.
1 - 256^(?!\s)(?!.*\s$)(?! *$)[A-Za-z0-9 ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖØÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõöøùúûüý þÿĀāĂ㥹ĆćĈĉĊċČčĎďĐđĒēĔĕĖėĘęĚěĜĝĞğĠġĢģĤĥĦħĨĩĪīĬĭĮįİıIJijĴĵĶķĸĹ ĺĻļĽľĿŀŁłŃńŅņŇňʼnŊŋŌōŎŏŐőŒœŔŕŖŗŘřŚśŜŝŞşŠšŢţŤťŦŧŨũŪūŬŭŮůŰűŲųŴŵ ŶŷŸŹźŻżŽžſǪǫȘșȚțȪȫȮȯȲȳḐḑṢṣẞỌọ'\-]+$"Doe"
The date and time when the card was created.
The date and time when the object/entity was updated last time.
The version number of the entity.
1
Email address of the cardholder. Max character limit is 256.
1 - 256"john.doe@test.com"
Tax Identification Number used for taxation, regulatory reporting, or authority requirements in many countries. Depending on regional regulatory or scheme mandates (for example Brazil requirements), this value may be forwarded to Mastercard. In some countries, this value may be the same as the customer registration or identification number (identificationNumber). Omit to keep current value.
1 - 64"ABCDEFGH123456789"
Date of birth of the cardholder. If you are using Enfuce as your BIN sponsor (under ELS or EUK licensing), you are required to populate this field due to regulatory requirements.
"1935-01-15"
Nationality of the cardholder. Maximum of 3 values. Duplicate values are not allowed. XXX may be used when nationality is unknown. XKX may be used for Kosovo. If you are using Enfuce as your BIN sponsor (under ELS or EUK licensing), you are required to populate this field due to regulatory requirements.
3ISO 3166-1 alpha-3 country codes. XKX is used for the Kosovo.
ABW, AFG, AGO, AIA, ALA, ALB, AND, ARE, ARG, ARM, ASM, ATA, ATF, ATG, AUS, AUT, AZE, BDI, BEL, BEN, BES, BFA, BGD, BGR, BHR, BHS, BIH, BLM, BLR, BLZ, BMU, BOL, BRA, BRB, BRN, BTN, BVT, BWA, CAF, CAN, CCK, CHE, CHL, CHN, CIV, CMR, COD, COG, COK, COL, COM, CPV, CRI, CUB, CUW, CXR, CYM, CYP, CZE, DEU, DJI, DMA, DNK, DOM, DZA, ECU, EGY, ERI, ESH, ESP, EST, ETH, FIN, FJI, FLK, FRA, FRO, FSM, GAB, GBR, GEO, GGY, GHA, GIB, GIN, GLP, GMB, GNB, GNQ, GRC, GRD, GRL, GTM, GUF, GUM, GUY, HKG, HMD, HND, HRV, HTI, HUN, IDN, IMN, IND, IOT, IRL, IRN, IRQ, ISL, ISR, ITA, JAM, JEY, JOR, JPN, KAZ, KEN, KGZ, KHM, KIR, KNA, KOR, KWT, LAO, LBN, LBR, LBY, LCA, LIE, LKA, LSO, LTU, LUX, LVA, MAC, MAF, MAR, MCO, MDA, MDG, MDV, MEX, MHL, MKD, MLI, MLT, MMR, MNE, MNG, MNP, MOZ, MRT, MSR, MTQ, MUS, MWI, MYS, MYT, NAM, NCL, NER, NFK, NGA, NIC, NIU, NLD, NOR, NPL, NRU, NZL, OMN, PAK, PAN, PCN, PER, PHL, PLW, PNG, POL, PRI, PRK, PRT, PRY, PSE, PYF, QAT, REU, ROU, RUS, RWA, SAU, SDN, SEN, SGP, SGS, SHN, SJM, SLB, SLE, SLV, SMR, SOM, SPM, SRB, SSD, STP, SUR, SVK, SVN, SWE, SWZ, SXM, SYC, SYR, TCA, TCD, TGO, THA, TJK, TKL, TKM, TLS, TON, TTO, TUN, TUR, TUV, TWN, TZA, UGA, UKR, UMI, URY, USA, UZB, VAT, VCT, VEN, VGB, VIR, VNM, VUT, WLF, WSM, YEM, ZAF, ZMB, ZWE, XKX "FIN"
Risk assessment score of the customer:
- High - High-risk customer
- Med - Medium-risk customer
- Low - Low-risk customer
- Pep - Politically Exposed Person (PEP)
- Prohibited - Customer sanctioned or outside of risk appetite
If you are using Enfuce as your BIN sponsor (under ELS or EUK licensing), you are required to populate this field due to regulatory requirements.
High, Med, Low, Pep, Prohibited "Med"
Cardholder's country of birth. If you are using Enfuce as your BIN sponsor (under ELS or EUK licensing), you are required to populate this field due to regulatory requirements.
ABW, AFG, AGO, AIA, ALA, ALB, AND, ARE, ARG, ARM, ASM, ATA, ATF, ATG, AUS, AUT, AZE, BDI, BEL, BEN, BES, BFA, BGD, BGR, BHR, BHS, BIH, BLM, BLR, BLZ, BMU, BOL, BRA, BRB, BRN, BTN, BVT, BWA, CAF, CAN, CCK, CHE, CHL, CHN, CIV, CMR, COD, COG, COK, COL, COM, CPV, CRI, CUB, CUW, CXR, CYM, CYP, CZE, DEU, DJI, DMA, DNK, DOM, DZA, ECU, EGY, ERI, ESH, ESP, EST, ETH, FIN, FJI, FLK, FRA, FRO, FSM, GAB, GBR, GEO, GGY, GHA, GIB, GIN, GLP, GMB, GNB, GNQ, GRC, GRD, GRL, GTM, GUF, GUM, GUY, HKG, HMD, HND, HRV, HTI, HUN, IDN, IMN, IND, IOT, IRL, IRN, IRQ, ISL, ISR, ITA, JAM, JEY, JOR, JPN, KAZ, KEN, KGZ, KHM, KIR, KNA, KOR, KWT, LAO, LBN, LBR, LBY, LCA, LIE, LKA, LSO, LTU, LUX, LVA, MAC, MAF, MAR, MCO, MDA, MDG, MDV, MEX, MHL, MKD, MLI, MLT, MMR, MNE, MNG, MNP, MOZ, MRT, MSR, MTQ, MUS, MWI, MYS, MYT, NAM, NCL, NER, NFK, NGA, NIC, NIU, NLD, NOR, NPL, NRU, NZL, OMN, PAK, PAN, PCN, PER, PHL, PLW, PNG, POL, PRI, PRK, PRT, PRY, PSE, PYF, QAT, REU, ROU, RUS, RWA, SAU, SDN, SEN, SGP, SGS, SHN, SJM, SLB, SLE, SLV, SMR, SOM, SPM, SRB, SSD, STP, SUR, SVK, SVN, SWE, SWZ, SXM, SYC, SYR, TCA, TCD, TGO, THA, TJK, TKL, TKM, TLS, TON, TTO, TUN, TUR, TUV, TWN, TZA, UGA, UKR, UMI, URY, USA, UZB, VAT, VCT, VEN, VGB, VIR, VNM, VUT, WLF, WSM, YEM, ZAF, ZMB, ZWE, XKX "FIN"
Customer or company identification number, such as a social security number (SSN), national identity number, or company registration number. Enfuce does not validate whether the provided identificationNumber is a real or officially valid identifier. Customers may populate this field according to their own business or regulatory needs. If you are using Enfuce as your BIN sponsor (under ELS or EUK licensing), you are required to populate this field for Finnish cardholders due to regulatory requirements.
1 - 64^[a-zA-Z0-9](?:[a-zA-Z0-9 \-_/.+]*[a-zA-Z0-9])?$"19560606-1234"
Response
Event processed successfully.

