---
title: "Registers a new payment account"
method: PUT
path: "/merchants/{mid}/users/{uid}/accounts/{paid}"
---

# Registers a new payment account

`PUT /merchants/{mid}/users/{uid}/accounts/{paid}`

## Request

- Base URL: `https://api.test.kalixa.com/api/v4`
- URL: `https://api.test.kalixa.com/api/v4/merchants/{mid}/users/{uid}/accounts/{paid}`
- Auth: none declared

Registers a new payment account

## Path parameters

- `mid` string, required
- `uid` string, required
- `paid` string, required

## Query parameters

- `token` string, required

## Request body

- Account: The account data entered by the user (e.g. credit card data)
  - `id` string, required: The payment account id
  - `type` number: The Account Type to be created. Currently only 1 (CreditCard) and 17 (DebitCard) are supported. The type of card will be automatically detected by Kalixa’s system and in case client specified incorrect card type the type will be overridden by Kalixa’s system and the client will receive actual type in the response.
  - `cardNumber` string: Account Type specific ( 1,17) .Credit/Debit card Number.
  - `expiryMonth` number: Account Type specific ( 1,17). Expiration Month of Credit/Debit card.
  - `expiryYear` number: Account Type specific ( 1,17). Expiration Year of Credit/Debit card.
  - `cardVerificationCode` string: Account Type specific ( 1,17). Autorization code of Credit/Debit card.
  - `holderName` string: Account Type specific ( 1,17). Holder name of Credit/Debit card.
  - `visible` string: Flag to signal if account can be used by customer. If this flag is set true than the account will be return when all available accounts for the user/method are requested with a GET method. By default it will be set to false.
  - `is3DSecureEnabled` boolean: Boolean parameter (true, false)
  - `lastSuccessfulDepositOn` string, dateTime: DateTime parameter
  - `cardType` string: The type of the card (e.g. Visa, Mastercard, Diners, etc.)
  - `fastFunds` boolean: Contains the information if the issuer of a particular card supports Fast Funds. Boolean parameter (true, false)

## Response `204`

Successful operation

- AccountsResponse
  - `accounts` Account[]
    - `id` string, required: The payment account id
    - `type` number: The Account Type to be created. Currently only 1 (CreditCard) and 17 (DebitCard) are supported. The type of card will be automatically detected by Kalixa’s system and in case client specified incorrect card type the type will be overridden by Kalixa’s system and the client will receive actual type in the response.
    - `cardNumber` string: Account Type specific ( 1,17) .Credit/Debit card Number.
    - `expiryMonth` number: Account Type specific ( 1,17). Expiration Month of Credit/Debit card.
    - `expiryYear` number: Account Type specific ( 1,17). Expiration Year of Credit/Debit card.
    - `cardVerificationCode` string: Account Type specific ( 1,17). Autorization code of Credit/Debit card.
    - `holderName` string: Account Type specific ( 1,17). Holder name of Credit/Debit card.
    - `visible` string: Flag to signal if account can be used by customer. If this flag is set true than the account will be return when all available accounts for the user/method are requested with a GET method. By default it will be set to false.
    - `is3DSecureEnabled` boolean: Boolean parameter (true, false)
    - `lastSuccessfulDepositOn` string, dateTime: DateTime parameter
    - `cardType` string: The type of the card (e.g. Visa, Mastercard, Diners, etc.)
    - `fastFunds` boolean: Contains the information if the issuer of a particular card supports Fast Funds. Boolean parameter (true, false)

## Other responses

- `400`: Invalid data supplied

---

[API](https://skmtc.dev/kalixa/apis/payment-service-v4.md) - [All operations](https://skmtc.dev/kalixa/apis/payment-service-v4/llms.txt) - [OpenAPI document](https://skmtc.dev/kalixa/apis/payment-service-v4/revisions/5b7869243a54?raw)