Creating a Trade
Creating a trade is what captures the subscription/investment made by an investor.
The Webhooks below can be utilized for verification of successful creation or deletion.
Creating a Trade API Method
Deleting a Trade API Method
WEBHOOKS
deleteTrade
createTrade
Trade Statuses
There are several trade statuses reflected in the trade process. Please see the definitions and graphic below which depicts the potential flow options for each trade from creation to completion.
Please note that trade statuses are different from payment processing statuses. Payment statuses can be found on the Payments Overview page.
The webhooks listed below can trigger a notification when statuses are updated. Definitions of each trade status are listed below.
Status Definitions
Created Funds are pending to be received in escrow
Funded Funds have been received in escrow
Canceled Funds were never received in escrow and the investor has canceled their intention to invest (this status is done through the deleteTrade method)
Unwind Pending Funds have been received in escrow and a return of funds back to the investor's bank account is pending
Unwind Settled Funds have been received in escrow and a return of funds back to the investor's bank account has processed
Settled Funds have been sent from escrow to the issuer/sponsor's bank account
Triggering a Settled Status
Once an investment has been completed and all funds have been sent to the issuer, you are able to update the trade to a SETTLED status by using the API method below.
API METHOD
WEBHOOKS
updateTradeStatus
deleteTrade
createTrade
Updated almost 2 years ago