Skip to main content
PATCH
Update Cardholder

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-audit-user
string

Optional audit user header

Path Parameters

id
string<uuid>
required

Enfuce generated unique identifier of the cardholder that you to modify.

Body

application/json

Cardholder details to be updated.

customerNumber
string

External unique identifier of the cardholder, set by the issuer. Can contain both letters and numbers. Max character limit is 36.

Required string length: 1 - 36
Pattern: ^[A-Za-z0-9-]+$
Example:

"ABCDEFGH123456789"

locale
enum<string>

Cardholder's language and country code in RFC 5646 format.

Available options:
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
Example:

"en-GB"

address
object
firstName
string

First name of the cardholder. Max character limit is 256.

Required string length: 1 - 256
Pattern: ^(?!\s)(?!.*\s$)(?! *$)[A-Za-z0-9 ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖØÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõöøùúûüý þÿĀāĂ㥹ĆćĈĉĊċČčĎďĐđĒēĔĕĖėĘęĚěĜĝĞğĠġĢģĤĥĦħĨĩĪīĬĭĮįİıIJijĴĵĶķĸĹ ĺĻļĽľĿŀŁłŃńŅņŇňʼnŊŋŌōŎŏŐőŒœŔŕŖŗŘřŚśŜŝŞşŠšŢţŤťŦŧŨũŪūŬŭŮůŰűŲųŴŵ ŶŷŸŹźŻżŽžſǪǫȘșȚțȪȫȮȯȲȳḐḑṢṣẞỌọ'\-]+$
Example:

"John"

middleName
string

Middle name of the cardholder. Max character limit is 256.

Required string length: 1 - 256
Pattern: ^(?!\s)(?!.*\s$)(?! *$)[A-Za-z0-9 ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖØÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõöøùúûüý þÿĀāĂ㥹ĆćĈĉĊċČčĎďĐđĒēĔĕĖėĘęĚěĜĝĞğĠġĢģĤĥĦħĨĩĪīĬĭĮįİıIJijĴĵĶķĸĹ ĺĻļĽľĿŀŁłŃńŅņŇňʼnŊŋŌōŎŏŐőŒœŔŕŖŗŘřŚśŜŝŞşŠšŢţŤťŦŧŨũŪūŬŭŮůŰűŲųŴŵ ŶŷŸŹźŻżŽžſǪǫȘșȚțȪȫȮȯȲȳḐḑṢṣẞỌọ'\-]+$
Example:

"James"

lastName
string

Last name of the cardholder. Max character limit is 256.

Required string length: 1 - 256
Pattern: ^(?!\s)(?!.*\s$)(?! *$)[A-Za-z0-9 ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖØÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõöøùúûüý þÿĀāĂ㥹ĆćĈĉĊċČčĎďĐđĒēĔĕĖėĘęĚěĜĝĞğĠġĢģĤĥĦħĨĩĪīĬĭĮįİıIJijĴĵĶķĸĹ ĺĻļĽľĿŀŁłŃńŅņŇňʼnŊŋŌōŎŏŐőŒœŔŕŖŗŘřŚśŜŝŞşŠšŢţŤťŦŧŨũŪūŬŭŮůŰűŲųŴŵ ŶŷŸŹźŻżŽžſǪǫȘșȚțȪȫȮȯȲȳḐḑṢṣẞỌọ'\-]+$
Example:

"Doe"

mobileNumber
string

Mobile number of the cardholder — it must be a full number, including the country code and starting with +.

Pattern: ([+]){1}([1-9]){1}([0-9]){5,14}
Example:

"+358401234567"

email
string<email>

Email address of the cardholder. Max character limit is 256.

Required string length: 1 - 256
Example:

"john.doe@test.com"

taxId
string | null

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.

Required string length: 1 - 64
Example:

"ABCDEFGH123456789"

dateOfBirth
string<date>

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.

Example:

"1935-01-15"

nationality
enum<string>[]

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.

Maximum array length: 3

ISO 3166-1 alpha-3 country codes. XKX is used for the Kosovo.

Available options:
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
Example:

"FIN"

Example:
riskScore
enum<string>

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.

Available options:
High,
Med,
Low,
Pep,
Prohibited
Example:

"Med"

birthCountry
enum<string>

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.

Available options:
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
Example:

"FIN"

identificationNumber
string

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.

Required string length: 1 - 64
Pattern: ^[a-zA-Z0-9](?:[a-zA-Z0-9 \-_/.+]*[a-zA-Z0-9])?$
Example:

"19560606-1234"

Response

Successful update of a cardholder.

description
string

A description of the response returned.

id
string<uuid>

A unique identifier assigned to identify the endpoint request.

Example:

"20218aae-b15e-406c-9e9f-23735cd86a48"