BillableAcknowledgmentNeededException
This error is caused by a mechanism designed to prevent unintentional charges to your account, in certain cases we need explicit consent to charges being made. Generally speaking actions you explicitly request and are commonly charged do not need consent, implicit charges need consent. Within the response body a quote for the requested action is included.
Renew domain, automatic domain renewal and restore domain never need explicit consent, you have already consented to the charges when the domain was created or transferred.
When needed you can further restrict yourself by adding billables that normally do not need consent with a quantity of zero (0), when you do this and a billable of that type would need be charged it will trigger this error.
| Request | Actions without need for consent | Actions with need for consent |
|---|---|---|
| Register domain | CREATE (non-premium), RENEW, PRIVACY_PROTECT | LOCAL_CONTACT, CREATE (premium) |
| Update domain | UPDATE, REGISTRANT_CHANGE, PRIVACY_PROTECT, LOCAL_CONTACT | |
| Renew domain | RENEW (non-premium) | RENEW (premium) |
| Transfer domain | TRANSFER (non-premium), RENEW, PRIVACY_PROTECT | TRANSFER (premium), LOCAL_CONTACT, TRANSFER_RESTORE |
- 400 Bad RequestHTTP Status
- application/jsonContent-Type
| Name | Type | Required / Optional | Description |
|---|---|---|---|
| product | String | Required | The product |
| action | Enum | Required |
The action
Possible values:
|
| quantity | Integer | Required | The quantity charged |
| amount | Integer | Required | The amount charged for this product |
| refundable | Boolean | Required | Whether the product is refundable |
| total | Integer | Required | Total; quantity times amount |