Skip to main content
POST
/
apply
Create Investment Application
curl --request POST \
  --url https://test-investment-products-service.fincode.software/api/v1/user/apply \
  --header 'Content-Type: application/json' \
  --header 'X-Auth-Token: <x-auth-token>' \
  --header 'platform: <platform>' \
  --header 'uuid: <uuid>' \
  --header 'x-idempotency-key: <x-idempotency-key>' \
  --data '
{
  "investmentProductId": "<string>",
  "numberOfUnitsToPurchase": 123,
  "userWalletId": "<string>",
  "customerId": "<string>",
  "customerName": "<string>"
}
'
Creates a new investment application allowing customers to invest in a specific investment product with a specified number of units.

​
Request Headers

​
X-Auth-Token
string
required
The JWT Access Token obtained from the /login or /refresh-token endpoint.
​
x-idempotency-key
string
required
Unique idempotency key for the request to prevent duplicate processing.
​
x-fapi-auth-date
string
required
The date and time at which the request was initiated (ISO 8601 format).
​
x-fapi-customer-ip-address
string
required
The IP address of the customer making the request.
​
x-fapi-interaction-id
string
required
Unique identifier for the interaction/session.
​
Content-Type
string
default:"application/json"
required
Must be application/json.

​
Request Body

​
investmentProductId
string
required
The unique identifier (UUID) of the investment product to invest in.
​
numberOfUnitsToPurchase
number
required
The number of units to purchase for this investment.
​
userWalletId
string
required
The unique identifier (UUID) of the user wallet to use for the investment.
​
customerId
string
required
The unique identifier (UUID) of the customer making the investment.
​
customerName
string
required
The full name of the customer making the investment.

​
Code Examples

curl --location --request POST 'https://test-investment-products-service.fincode.software/api/v1/user/apply' \
--header 'X-Auth-Token: YOUR_JWT_ACCESS_TOKEN' \
--header 'x-idempotency-key: unique-key-12345' \
--header 'x-fapi-auth-date: 2024-01-15T10:30:00Z' \
--header 'x-fapi-customer-ip-address: 192.168.1.1' \
--header 'x-fapi-interaction-id: interaction-12345' \
--header 'Content-Type: application/json' \
--data '{
    "investmentProductId": "123e4567-e89b-12d3-a456-426614174000",
    "numberOfUnitsToPurchase": 100,
    "userWalletId": "123e4567-e89b-12d3-a456-426614174001",
    "customerId": "123e4567-e89b-12d3-a456-426614174002",
    "customerName": "John Doe"
}'

Headers

​
platform
string
default:fincode
required
​
uuid
string
default:200
required
​
X-Auth-Token
string
required
​
x-idempotency-key
string
required

Body

application/json
​
investmentProductId
string
​
numberOfUnitsToPurchase
number
​
userWalletId
string
​
customerId
string
​
customerName
string

Response

200

Application created