post
https://apis.wattbuy.com/v3/form
Submits an enrollment for the given offer. Before making this call, GET /form should
already have been called to retrieve the required fields for the offer.
The request body should contain the form fields as defined in the GET /form response
for the selected offer_id. The response shape varies by offer category.
Note: This API should use the enroll.wattbuy.com base URL rather than apis.wattbuy.com. It is also recommended that you use QA (qaenroll.wattbuy.com) for development.
For retail electricity offers, this endpoint returns the code, status, sub status, agent, and metadata.
The metadata includes:
- Customer info fields
- WattBuy order_id for further reference
- reference_id from the supplier (if provided by the supplier)
- status_reason if the order fails
- deposit amount and payment link if a deposit is required
Order Status Metrix:
| Code | Status | Sub Status | Description |
|---|---|---|---|
| S1 | SUBMITTED | Approved | The enrollment has been successfully submitted to the supplier but service has not started |
| S2 | SUBMITTED | Approved with Deposit Needed | The enrollment has been successfully submitted to the supplier but a deposit is needed to turn on service |
| S3 | SUBMITTED | Approved with Deposit Waiver Needed | The enrollment has been successfully submitted to the supplier but a deposit waiver is needed to turn on service |
| F3 | FAILED | Declined | The enrollment has been declined by the supplier |