Skip to main content

Send Signed Subscription Note


Introduction​

This resource is used to send us the proof of signature of an investor's subscription note to a fund's quota offering.

Attention

This resource is available only for integrations acting as Distributor. Use the API key and the host of the Distributor profile: see Environments (Hosts).

Input / Output:​

As input, the subscription information, the UUID of the quota offering the investor subscribed to, the signature method and, depending on the method, the content needed for validation must be sent. See the example below.

As output, the full object of the created subscription note is delivered, including the subscription_note_key, which identifies the note. The note is created already in the active status (or sold_off, if remaining_subscription_note_value is zero).

Request​

ENDPOINT
/quota_offering_control/investor/INVESTOR_KEY/signed_subscription_note
METHOD
POST
STATUS
201

Request body​

Request Body
{
"number_of_quotas": 500.0,
"original_subscription_note_value": 50000.00,
"start_date": "2026-01-15",
"maturity_date": "2026-12-31",
"quota_offering_key": "UUID",
"transaction_type": "ted",
"signature_method": "opt_in",
"opt_in_hash" : "OPT_IN_HASH"
}
FieldTypeDescriptionRequired
original_subscription_note_valuenumberNote value. Minimum 0. Cannot exceed the offering's remaining valueYes
quota_offering_keystringUUID of the quota offering. The offering must be active, with remaining value and no pending amendmentYes
transaction_typestringted or b3Yes
signature_methodstringSignature method used. With opt_in, send opt_in_hash; with any other method, send document_b64Yes
opt_in_hashstringOpt-in hash (up to 250 characters)No
document_b64stringSigned note encoded in base64No
number_of_quotasnumberNumber of quotas of the noteNo
remaining_subscription_note_valuenumberRemaining balance of the note. Cannot be greater than original_subscription_note_valueNo
start_datestringStart date (YYYY-MM-DD). If omitted, the current date (UTC) is usedNo
maturity_datestringMaturity date (YYYY-MM-DD). Cannot be in the pastNo
Attention

During the integration process, a means of authenticating the submitted hash will be required.

Response​

The response has the same format as the Request Subscription Note response.

Errors​

StatusCodeWhen it happens
400QOF000020maturity_date is in the past
400QOF000026The note value is greater than the offering's remaining value
400QOF000046Invalid transaction_type
400QOF000047The investor's classification does not allow subscribing to the offering
400QOF000068Invalid signature_method
400QOF000069signature_method is opt_in and opt_in_hash was not sent
400QOF000072signature_method is not opt_in and document_b64 was not sent
400QOF000150remaining_subscription_note_value is greater than original_subscription_note_value
400QIT000004The integration is not the investor's distributor
404QOF000017Investor not found
404QOF000019Quota offering not found
404QOF000039The offering is not active, has expired or has no remaining value
409QOF000152The offering has an amendment waiting for approval

Authentication, permission and host errors: see API Errors.