DEBT Pay
Initiate a crowd pay transaction to post interest or principal to a debt asset. In addition, this API function can also mature an asset and apply the cash to the crowd pay account of the matured asset.
Submission | Current Date | Transaction Date | Example | Transaction Status | Account Available Balance |
01/05/2015 2:30 PM | 01/05/2015 | 01/08/2015 | Before 3:00 PM | PENDING changes to PROCESSED when GoldStar posts transactions on 01/05/2015 | For 301 and 305 Transactions, amount is added to available balance after GoldStar “Posts” transactions on 01/05/2015 |
01/05/2015 3:30 PM | 01/06/2015 | 01/06/2015 | After 3:00 PM | PENDING changes to PROCESSED when GoldStar posts transactions on 01/06/2015 | For 301 and 305 Transactions, amount is added to available balance after GoldStar “Posts” transactions on 01/06/2015 |
REQUEST
Content-Type: application/json
QA Environment
POST https://qaservices.goldstartrust.com/Crowdfunding/api/Account/account_id/Transaction/DebtPay
*****VERY IMPORTANT*****
asset_id in content must represent the asset_id of the debt asset that you wish to mature.
activity_code
- 301 – amount = amount of interest income that you wish to apply to asset
- 304 – amount = amount of increase in asset principal
- 305 – Sell/mature asset
- Enter amount = 0 or book value/cost basis – The asset’s book value or amount value will show up as cash in crowd pay account
- sold_date – if null, we will use transaction date (you should leave as null unless you know what you want valued in this field)
{ "account_id": 1234567, "asset_id": 987654, "activity_code": "305", "sold_date": null, "reference": "yourtransactionreferencenumber", "description": "description you would like placed on transaction", "amount": 100.00, "created_by_ip_address": "123.456.789.012" }
Response
Notice the id. This id is GoldStar Trust’s internal unique identifier for the transaction. The asset_id can be used with Get Asset and Get Asset with Transactions api functions.
{ "id": 6580369, "account_id": 1234567, "asset_id": 987654, "activity_code": "305", "sold_date": 2015-06-01T00:00:00, "reference": "yourtransactionreferencenumber", "description": "description you would like placed on transaction", "amount": 100.00, "created_by_ip_address": "123.456.789.012", "status": "Pending" }