Sign in

v1

latestOpenAPI 3.1.02026-07-24416405768.8 KB
e) Organisation Management

Create a wallet for the organisation

Creates a new wallet linked to the organisation. If this is a card wallet it will also create the first linked card, retrievable via the wallet mappings.

post/eclipse-conductor/rest/v1/tenants/{tenantId}/organisations/{organisationId}/wallets

Path parameters

tenantIdinteger required
organisationIdinteger required

Request body

customerIdinteger

The customer who will be issued the first card on the wallet if this wallet type is a card mode. For digital wallets this allows the wallet to be associated to an organisation and a customer at the same time (but the customer must have a position in the organisation)

descriptionstring

Wallet Description

externalUniqueIdstring required

A globally unique identifier set by the tenant for this wallet. Useful for correlating between the tenants systems and Eclipse

namestring

Name of the Wallet

status'ACTIVE' | 'BARRED' | 'CANCELED' | 'CANCELLED' | 'JOINT_ACTIVE' | 'JOINT_PARTIAL' | 'LOCKED' | 'PENDING' required

Status of the wallet. ACTIVE:Can be used, LOCKED:Is blocked from use but can be customer controlled. CANCELED is deprecated. CANCELLED is in use, BARRED: Wallet cannot be used due to possible fraud or similar investigation

walletTypeIdinteger required

The type of wallet. This controls the behaviour and rules of the wallet

Example request

{
  "primaryPhysicalCardIdentifier": {
    "expiry": "2022-03-10T12:15:50-04:00"
  }
}

Response

OK

accountNumberstring

A bank account number for deposits if supported by the underlying bank

availableBalancenumber

The amount available for spending

createdstring date-time

ISO 8601 date/time of when the record was first created

creditReservationsnumber

The credit reservations placed on the wallet (uncommitted transactions that will credit the wallet)

currencystring required

The currency of the wallet - e.g. USD, ZAR, NGN, TSH

currentBalancenumber

The balance in the wallet in the currency of the wallet

customerIdinteger

The customer who owns this wallet. If not provided then the wallet must be owned by an organisation and hence organisationId should be provided

debitReservationsnumber

The debit reservations placed on the wallet (uncommitted transactions)

descriptionstring

Wallet Description

externalUniqueIdstring

A globally unique identifier set by the tenant for this wallet. Useful for correlating between the tenants systems and Eclipse

friendlyIdstring

A unique reference for a wallet used for deposits and other transactions

namestring

Name of the Wallet

organisationIdinteger

The organisation who owns this wallet. If not provided then the wallet must be owned by a customer and hence customerId should be provided

reasonCode'DUE_DILIGENCE' | 'EXCON' | 'FRAUD' | 'LEGAL' | 'NONE' | 'REGULATORY' | 'RISK'
reservationsnumber

Deprecated - use debitReservations. The reservations placed on the wallet (uncommitted transactions that will debit the wallet)

status'ACTIVE' | 'BARRED' | 'CANCELED' | 'CANCELLED' | 'JOINT_ACTIVE' | 'JOINT_PARTIAL' | 'LOCKED' | 'PENDING' required

Status of the wallet. ACTIVE:Can be used, LOCKED:Is blocked from use but can be customer controlled. CANCELED is deprecated. CANCELLED is in use, BARRED: Wallet cannot be used due to possible fraud or similar investigation

voucherPinstring
walletIdinteger

A unique system generated numeric identifier for the wallet

walletTypeIdinteger

The type of wallet. This controls the behaviour and rules of the wallet

Example response

{
  "created": "2022-03-10T12:15:50-04:00"
}