commit 1cf1485e89dca90e13ecca8a064b7b9c849cae55 parent 6878d9b338e7616461c75361f85929e7e60391f5 Author: Florian Dold <florian@dold.me> Date: Mon, 4 Aug 2025 18:42:51 +0200 merchant: public instance creation endpoint Diffstat:
| M | core/api-merchant.rst | | | 25 | +++++++++++++++++++++++++ |
1 file changed, 25 insertions(+), 0 deletions(-)
diff --git a/core/api-merchant.rst b/core/api-merchant.rst @@ -1221,6 +1221,31 @@ instance setup before it can be used to manage inventory or process payments. Setting up instances -------------------- +.. http:post:: /instances + + This request will be used to create a new merchant instance in the backend. + + Only available if self-provisioning is enabled. + + **Required permission:** none + + **Request:** + + The request must be a `InstanceConfigurationMessage`. + + **Response:** + + :http:statuscode:`204 No content`: + The backend has successfully created the instance. + :http:statuscode:`409 Conflict`: + This instance already exists, but with other configuration options. + Use "PATCH" to update an instance configuration. Alternatively, + the currency provided in the configuration does not match the + currency supported by this backend. Another possible conflict + would be if a deleted but not purged instance is known under this + ID to the backend. + + .. http:post:: /management/instances This request will be used to create a new merchant instance in the backend.