Skip to main content

Update Account

PATCH 
/accounts/:customerAccountId

This endpoint updates an existing account, previously created through a checkout API call, using the provided customerAccountId input parameter.

Request​

Path Parameters

    customerAccountId stringrequired

    Possible values: <= 255 characters

    Customer identifier

    Example: john_doe_12345

Header Parameters

    Content-Type stringrequired

    Must be application/json

    Accept-Language stringrequired

    Must be be en-US

    Origin stringrequired

    The origin of the request

    User-Agent stringrequired

    The client making the request

Bodyrequired

    billingAddress objectrequired

    Consumer's billing address data. See Address in Data model.

    addressLine1stringrequired

    Street name.

    Possible values: <= 60 characters

    Example: Max-Planck-Straße
    addressLine2string

    Apartment, suite, unit, building, floor or other secondary address information.

    Possible values: <= 60 characters

    addressLine3string

    Specific delivery instructions, department names, or additional floor information.

    Possible values: <= 60 characters

    citystringrequired

    The city or localitly of the address.

    Possible values: <= 50 characters

    Example: Berlin
    countryCodestringrequired

    ISO-3 code of the address country (e.g., DEU for Germany).

    Possible values: >= 3 characters and <= 3 characters

    Example: DEU
    numberstring

    The house or building number corresponding to the street address.

    Possible values: <= 10 characters

    Example: 30
    postCodestringrequired

    The postal or ZIP code of the address.

    Possible values: <= 10 characters

    Example: 14473
    statestring

    3-letter code of the address state. Mandatory when countryCode corresponds to Canada or USA.

    Possible values: <= 3 characters

    consumer objectnullablerequired

    Consumer's personal data, in case the consumer is a physical person. See consumer in Data model.
    Conditional. Can be present if businessConsumer is missing from the request.

    culturestring

    Consists of ISO 639-1 language code and ISO 3166-1 alpha-2 country code separated by dash. If this value is not provided the browser culture is used. Default culture is English (e.g., en-de). This field is not case sensitive.

    Possible values: <= 5 characters

    Example: en-EN
    dateOfBirthstring<date>

    Date of birth. Format - YYYY-MM-DD. Mandatory for payment option registration flow. Minimum date allowed is 1900-01-01

    Possible values: <= 10 characters, Value must match regular expression ^\d{4}-\d{2}-\d{2}$

    Example: 1989-11-08
    emailAddressstring<email>required

    Customer email address for any notification

    Possible values: <= 255 characters

    Example: john.doe@gmail.com
    firstNamestringrequired

    Person first name

    Possible values: <= 60 characters

    Example: John
    genderstring

    Person gender

    Possible values: <= 6 characters

    Example: Mr
    homePhonestring

    Person's home phone number (including the country code)

    Possible values: <= 30 characters

    Example: 496912345678
    lastNamestringrequired

    Person last name

    Possible values: <= 60 characters

    Example: Doe
    merchantCustomerIdstring

    Consumer/Customer Account Id in the merchant system. When provided into the Create Checkout API, SmartPay will request e-wallet account creation which will have external account reference equals to the given merchantCustomerId value.

    Possible values: <= 255 characters

    Example: abcd123
    middleNamestring

    The customer's middle name

    Possible values: <= 60 characters

    Example: Robert
    mobilePhonestring

    Person's mobile phone number (including the country code)

    Possible values: <= 30 characters

    Example: 496912345678
    taxIdstring

    Person's tax identification number

    Possible values: <= 30 characters

    Example: 123456789
    timezonestring

    Preferred timezone name

    Possible values: <= 50 characters

    Example: CET
    titlestring

    Person title

    Possible values: <= 3 characters

    Example: Mr
    workPhonestring

    Person's work phone number (including the country code)

    Possible values: <= 30 characters

    Example: 496912345678
    businessConsumer objectnullablerequired

    Company data, in case the consumer is a business or a legal entity. See businessConsumer in Data model.
    Conditional. Can be present if consumer is missing from the request.

    companyNamestringrequired

    Name of the legal entity

    Possible values: <= 100 characters

    companyRegistrationCountryCodestring

    Company registration country ISO2 or ISO3 code

    Possible values: >= 2 characters and <= 3 characters

    companyRegistrationNumberstring

    Company registration number

    Possible values: <= 50 characters

    companyTypestringrequired

    Possible values: <= 100 characters

    culturestring

    Consists of ISO 639-1 language code and ISO 3166-1 alpha-2 country code separated by dash. If this value is not provided the browser culture is used. Default culture is English (e.g., en-de). This field is not case sensitive.

    Possible values: <= 5 characters

    Example: en-EN
    emailAddressstringrequired

    Customer email address for any notification

    Possible values: <= 255 characters

    taxIdstring

    Person's tax identification number

    Possible values: <= 30 characters

Responses​

Successful response

Schema
    partnerReferencestring

    Partner service call identifier.

    Possible values: <= 64 characters, Value must match regular expression ^[a-zA-Z0-9_-]+$

    statusCodestring

    Status code of the account. Possible values are: ACTIVE, CLOSED, INACTIVE or REJECTED.

    Possible values: [ACTIVE, CLOSED, INACTIVE, REJECTED]

    accFlowStatusCodestring

    Status code of the account flow.

    Possible values: <= 10 characters

    twoFAStatusCodestring

    Two Factor Authentication Status Code. Possible values are:

    • 2FADIS - Two Factor Authentication is disabled.
    • 2FANOTCONF- Two Factor Authentication is activated but not configured.
    • 2FAINPROC - Two Factor Authentication is activated and configuration is in process.
    • 2FACONF - Two Factor Authentication is activated and configured.

    Possible values: [2FADIS, 2FANOTCONF, 2FAINPROC, 2FACONF]

    isTwoFASetupCodeRequiredboolean

    Whether a confirmation of Two-Factor Authentication setup with a verification code is required or not (this code is sent to the user email).

    providerResponse object

    External provider data.

    complianceData object[]

    Compliance data.

  • Array [
    • archiveIdstring

    Archived check result identifier.

    Possible values: <= 50 characters

    trafficLightstring

    The following options are possible:
    RED" - hit,<br/> YELLOW- unsure hit,<br/>GREEN` - no hit.

    Possible values: [RED, YELLOW, GREEN]

    hitTypestring

    The following options are possible:
    SL – sanctions list,
    BL – black list,
    PEP – publicly exposed person.
    Due to regulatory requirements, a person or company must not be part of this list.

    Possible values: [SL, BL, PEP]

    manualReviewboolean

    Whether a manual review is required or not.

    details object[]

    List of compliance check details.

  • Array [
    • namestring
    birthdatestring<date>
  • ]
  • ]
    • requestDateTimestring<date-time>

    Timestamp of the request in the format defined by ISO 8601.

    responseCodestring

    The response code.

    Possible values: <= 4 characters

    responseDescriptionstring

    The response description.

    Possible values: <= 512 characters

 Imprint
|
Data protection and privacy
© 2026 J.P. Morgan Mobility Payments Systems GmbH. All rights reserved.