Skip to main content

Update

POST 

/updateMerchantUser/:merchantUserGuid

Update the given merchant user.

Request

Query Parameters

    merchantUserGuid stringrequired

    Identifier of the merchant user.

Body

required

Fields of a merchant user to update, omit fields that should remain the same.

    username string

    Possible values: >= 3 characters

    type MerchantUserType (string)required

    Possible values: [web, api]

    email email

    Mandatory for web users.

    password string

    Mandatory for

    • api users
    • web users if sendInitialPassword is false
    firstName string
    lastName string
    validUntil date-time
    disabled boolean
    multiMerchantAccess string[]

    List of merchant GUIDs the user can access, overwrites existing list.

    merchantAccess

    MerchantLink[]

    List of merchants the user can access.

  • Array [

  • name string

    Possible values: >= 3 characters

  • ]

  • permissions MerchantUserPermission (string)[]

    Possible values: [frontend.dashboard.payout-forecast, frontend.dashboard.financial-summary, frontend.blacklist.show, frontend.blacklist.edit, frontend.blacklist.show-admin-values, frontend.whitelist.show, frontend.whitelist.edit, frontend.whitelist.show-admin-values, frontend.payment-template.edit, frontend.show-connectors.real-connectors, frontend.show-connectors.meta-connectors, frontend.transaction.detailed-fees, frontend.transaction.adapter-txid-visible, frontend.transaction.risk-check-result, frontend.transaction.data-export, frontend.transaction.refund, frontend.transaction.void, frontend.transaction.capture, frontend.transaction.settlement-state, frontend.virtual-terminal.use, frontend.virtual-terminal.register, frontend.virtual-terminal.surcharge, frontend.postprocessing.documents, frontend.schedule.start, frontend.schedule.show, frontend.schedule.pause, frontend.schedule.continue, frontend.schedule.cancel, frontend.schedule.retry, frontend.customer-profiles.show, frontend.customer-profiles.prefer, frontend.customer-profiles.update, frontend.customer-profiles.delete, frontend.customer-profiles.detach, frontend.customer-profiles.deregister-and-detach, frontend.customer-profiles.transactions, frontend.representment.show]

    For web users only: permissions of the user.

    sendInitialPassword boolean

    For web users only: send an initial password via email.

    apiUserSettings

    object

    push-api booleannullable
    fees-api booleannullable
    cde-login-enabled booleannullable
    snapshot-retrieval-enabled booleannullable
    addMultiMerchantAccess string[]

    List of merchant GUIDs to add to the list of merchants the user can access.

    removeMultiMerchantAccess string[]

    List of merchant GUIDs to remove from the list of merchants the user can access.

    addPermissions MerchantUserPermission (string)[]

    Possible values: [frontend.dashboard.payout-forecast, frontend.dashboard.financial-summary, frontend.blacklist.show, frontend.blacklist.edit, frontend.blacklist.show-admin-values, frontend.whitelist.show, frontend.whitelist.edit, frontend.whitelist.show-admin-values, frontend.payment-template.edit, frontend.show-connectors.real-connectors, frontend.show-connectors.meta-connectors, frontend.transaction.detailed-fees, frontend.transaction.adapter-txid-visible, frontend.transaction.risk-check-result, frontend.transaction.data-export, frontend.transaction.refund, frontend.transaction.void, frontend.transaction.capture, frontend.transaction.settlement-state, frontend.virtual-terminal.use, frontend.virtual-terminal.register, frontend.virtual-terminal.surcharge, frontend.postprocessing.documents, frontend.schedule.start, frontend.schedule.show, frontend.schedule.pause, frontend.schedule.continue, frontend.schedule.cancel, frontend.schedule.retry, frontend.customer-profiles.show, frontend.customer-profiles.prefer, frontend.customer-profiles.update, frontend.customer-profiles.delete, frontend.customer-profiles.detach, frontend.customer-profiles.deregister-and-detach, frontend.customer-profiles.transactions, frontend.representment.show]

    For web users only: add permissions for the user.

    removePermissions MerchantUserPermission (string)[]

    Possible values: [frontend.dashboard.payout-forecast, frontend.dashboard.financial-summary, frontend.blacklist.show, frontend.blacklist.edit, frontend.blacklist.show-admin-values, frontend.whitelist.show, frontend.whitelist.edit, frontend.whitelist.show-admin-values, frontend.payment-template.edit, frontend.show-connectors.real-connectors, frontend.show-connectors.meta-connectors, frontend.transaction.detailed-fees, frontend.transaction.adapter-txid-visible, frontend.transaction.risk-check-result, frontend.transaction.data-export, frontend.transaction.refund, frontend.transaction.void, frontend.transaction.capture, frontend.transaction.settlement-state, frontend.virtual-terminal.use, frontend.virtual-terminal.register, frontend.virtual-terminal.surcharge, frontend.postprocessing.documents, frontend.schedule.start, frontend.schedule.show, frontend.schedule.pause, frontend.schedule.continue, frontend.schedule.cancel, frontend.schedule.retry, frontend.customer-profiles.show, frontend.customer-profiles.prefer, frontend.customer-profiles.update, frontend.customer-profiles.delete, frontend.customer-profiles.detach, frontend.customer-profiles.deregister-and-detach, frontend.customer-profiles.transactions, frontend.representment.show]

    For web users only: remove permissions for the user.

    resetPassword boolean

    For web users only: reset the password and send out a password recovery email.

Responses

The updated merchant.

Schema

    success booleanrequired

    Whether the request was successful or not.

    merchantUser

    object

    guid stringrequired

    Identifier.

    username string

    Possible values: >= 3 characters

    type MerchantUserType (string)required

    Possible values: [web, api]

    email email

    Mandatory for web users.

    createdAt date-time
    requirePasswordChange boolean

    Whether a password change is required.

    passwordValidUntil date-time
    firstName string
    lastName string
    validUntil date-time
    disabled boolean
    archived boolean

    merchantAccess

    MerchantLink[]

    List of merchants the user can access.

  • Array [

  • guid string

    Identifier.

    name string

    Possible values: >= 3 characters

  • ]

  • permissions MerchantUserPermission (string)[]

    Possible values: [frontend.dashboard.payout-forecast, frontend.dashboard.financial-summary, frontend.blacklist.show, frontend.blacklist.edit, frontend.blacklist.show-admin-values, frontend.whitelist.show, frontend.whitelist.edit, frontend.whitelist.show-admin-values, frontend.payment-template.edit, frontend.show-connectors.real-connectors, frontend.show-connectors.meta-connectors, frontend.transaction.detailed-fees, frontend.transaction.adapter-txid-visible, frontend.transaction.risk-check-result, frontend.transaction.data-export, frontend.transaction.refund, frontend.transaction.void, frontend.transaction.capture, frontend.transaction.settlement-state, frontend.virtual-terminal.use, frontend.virtual-terminal.register, frontend.virtual-terminal.surcharge, frontend.postprocessing.documents, frontend.schedule.start, frontend.schedule.show, frontend.schedule.pause, frontend.schedule.continue, frontend.schedule.cancel, frontend.schedule.retry, frontend.customer-profiles.show, frontend.customer-profiles.prefer, frontend.customer-profiles.update, frontend.customer-profiles.delete, frontend.customer-profiles.detach, frontend.customer-profiles.deregister-and-detach, frontend.customer-profiles.transactions, frontend.representment.show]

    For web users only: permissions of the user.

    apiUserSettings

    object

    push-api booleannullable
    fees-api booleannullable
    cde-login-enabled booleannullable
    snapshot-retrieval-enabled booleannullable
    property name* any
Loading...