2 - Create an order on behalf of an investor => set order to "Initiated" status

POST {{base_url_servicing}}/subscriptions/{{subscription_id}}/tokens/{{token_id}}/investor-orders

https://docs.tokeny.com/reference/investororderscreation

Create an open-ended subscription order

This is an agent endpoint - make sure to input an agent bearer in the header.

This endpoint will set the order to staus: Initiated

An Agent creates an order, for and on behalf of, an investor.

After creating an order, it is considered as a ‘draft’ since there could be a DocuSign needed. Therefore, the order is not set to pending automatically.

If there is no need for a DocuSign, you can:

  1. Call Create order endpoint
  2. Right after, call the Confirm payment endpoint

Request Body

{"investmentCurrency"=>"EUR", "amountToPay"=>"25000", "identityId"=>"4d9f9ba9-8138-4a6e-af4a-95767f974343"}

RESPONSES

status: Created

{"id":"2e5c4066-eae2-41a9-bb7b-f28f102aa9ab","subscriptionId":"32ddf600-7ed5-4df8-b3d6-42345d25af3b","tokenId":"ed71ea99-19b7-4fb0-bbcc-ed3250a57c25","subscriptionIntervalId":"32ddf600-7ed5-4df8-b3d6-42345d25af3b","holderIdentityId":"ca9220ad-30e0-44d7-b16c-b8df296f5b83","holderId":"d08d9ddd-53a7-4d74-b5b1-64bbc73eac5e","holderName":"FirstN LastN","holderEmail":"publiclyavailabledummyinvestorfive@yopmail.com","tokenPrice":"2","tokenPriceAt":"2023-04-20T13:59:20.882Z","baseCurrency":"EUR","investmentCurrency":"USD","status":"Initiated","feeAtCreation":"66.66","investmentAmountAtCreation":"3266.34","tokensAtCreation":"1529","exchangeRateAtCreation":"1.068228","exchangeRateDateAtCreation":"2023-02-21T00:00:22.199Z","paymentReference":"f33cf7b4c5","feeAtPayment":null,"docuSignEnvelop":null,"distributorId":null,"investmentAmountAtPayment":null,"investmentAmountAtPaymentInBaseCurrency":null,"tokensAtPayment":null,"exchangeRateAtPayment":null,"exchangeRateType":null,"exchangeRateDateAtPayment":null,"confirmedAt":null,"txHash":null,"paymentNetwork":null,"createdAt":"2023-04-20T13:59:20.885Z","updatedAt":"2023-04-20T13:59:20.885Z"}