POST /instances

This request will be used to create a new merchant instance in the backend. Since protocol v21.

Only available if self-provisioning is enabled.

Required permission: none

Request:

The request must be a InstanceConfigurationRequest.

Query Parameters:

• token_validity_ms=DURATION – Optional. Pass a non-zero DURATION in milliseconds to get a refreshable login token for the SPA with the given validity duration in the response. @since v21.

Response:

200 Ok:

The backend has successfully created the instance. Body will be an LoginTokenSuccessResponse with a refreshable login token for the SPA as requested. @since v21.

202 Accepted:

2FA is required for this operation, usually to validate the email and/or phone numbers provided for the instance. This returns the ChallengeResponse. @since v21

204 No Content:

The backend has successfully created the instance. No login token was requested, so nothing is returned.

400 Bad Request:

The request body is malformed or a required field is missing. Returned with TALER_EC_GENERIC_PARAMETER_MALFORMED or TALER_EC_GENERIC_PARAMETER_MISSING.

403 Forbidden:

Self-provisioning is not enabled. Returned with TALER_EC_MERCHANT_GENERIC_UNAUTHORIZED.

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.

413 Request entity too large:

The uploaded body is to long, it exceeds the size limit. Returned with an error code of TALER_EC_GENERIC_UPLOAD_EXCEEDS_LIMIT.

500 Internal Server Error:

The server experienced an internal failure. Returned with TALER_EC_GENERIC_DB_STORE_FAILED.