v1

latestOpenAPI 3.0.32026-07-26208618579.9 KB

Create an account

Create credit account

This operation will create a credit account

post/v4/CREDIT/customer/{customerId}

Path parameters

customerIdstring biginteger required

The customer id of which customer you want to create the account on

Query parameters

auditUserstring required

The audit user to log the request

Request body

Field enables to group an entity into a segment. This field will be exported but no logic is applied to this in Enfuce API

pinStatus'D' | 'W' | 'S'

This flag will indicate current status for PIN generation. If not specified system will automatically assign D as default and make sure a PIN is calculated during next embossing process. If set to W, then card will be excluded from embossing process until a PIN has been set and status has been updated to S. It is also possible to revert to D, in order for system to generate PIN. Note that system will update to status S automatically when a PIN is set successfully.

New card

In order for a new card to not get a system generated PIN then pinStatus flag must be set to W when created, this will then halt the embossing process for given card until a PIN has been set.

Reissue card

When reissuing a card it is possible to set pinStatus to W in order to hold embossing process for given card until a PIN has been set. Update pinStatus is done on same card id that is reissued.

Replace card

When replacing a card it is possible to set pinStatus to W in order to hold embossing process for given card until a PIN has been set. Update pinStatus is done on new card id that is returned when replacing.

D - default and a random PIN will be generated
W - waiting for PIN to be manually set
S - PIN has been set successfully

digitalLayoutCodestring

Id used for digital wallet artwork and other related assets. Use of this need to be agreed with Enfuce separately

encryptedDatastring

JWE encrypted card number, see details above

parentIdstring biginteger

This field is used when the institution is setting up an account liability hierarchy. The parentId is used to determine the parent of this account. Consult Enfuce before using this field.

creditLimitnumber required

Credit limit of the account

paymentTermsinteger

Number of days to allow for invoice to be paid before it goes overdue.

Use of this field as well as the values of the field, is dependent on institution setup and should be aligned with Enfuce before taking into use.

invoiceDayOfMonthinteger

This indicates the last day of the billing period. An invoice is created and sent on the next day. If the scheduled day exceeds the total number of days in a month, then the invoice is generated on last day of the month.

productCodestring

This field is used when the institution has multiple account products setup. The productCode is used to determine the specific account product. Use of this field as well as the values of the field, is dependent on institution setup and should be aligned with Enfuce prior to use.

invoicePaymentMethod'DIRECT_DEBIT' | 'PLUS_GIROT' | 'BANK_GIROT' | 'BANK_TRANSFER' | 'IBAN'

Use of this field as well as the values of the field, is dependent on institution setup and should be aligned with Enfuce prior to use. Also, it is only a value, there is no functionality behind it.

Example request

{
  "expiration": {
    "year": 2019,
    "month": 1
  },
  "digitalLayoutCode": "abc123abc",
  "scheduledClosing": {
    "time": "2099-12-31T03:00:00.000Z"
  },
  "creditLimit": 10000,
  "paymentTerms": 10,
  "eInvoice": {
    "address": "FI7165429021331431",
    "operator": "NDEAFIHH",
    "paymentInstruction": "AA"
  },
  "invoiceDayOfMonth": 21,
  "productCode": "CARD_EUR_FI"
}

Response

Successful creation of the account

descriptionstring

Short description of the result of the action

idstring

Will contain the ID of the resource that has been created or updated