Xsolla-logo

Create project

post/merchants/{merchant_id}/projects

Creates a new project.

SecuritybasicAuth
Request
path Parameters
merchant_id
required
integer

Merchant ID.

Request Body schema: application/json
payment_url
string

Webhook URL.

key
string

Project secret key.

return_url
string

URL to redirect a user to after a successful payment. For mobile apps, it might be а URL or a path within the app itself (e.g.: app://home).

user_billing_enabled
boolean

Whether to keep user data in the Xsolla database.

show_user_in_paystation
boolean

Whether to show the user's saved payment accounts and payment history in the payment UI.

user_public_id_enabled
boolean

Enables user details verification via Public User ID (for payments through cash kiosks).

is_external_id_required
boolean

Whether External ID is required for integration with Xsolla.

ipn_enabled
boolean

If true, Xsolla will send an HTTP payload to the webhook's configured URL when certain events occur. The webhook URL is set in the payment_url parameter.

is_universal_item_enabled
boolean

Whether to have an account type that allows to use the Xsolla SDKs.

send_email_for_user_billing_purchase
boolean

Whether to send email notifications to user for balance transactions.

autoredirect_from_status_page
string

Autoredirect status. Possible values:

  • none (none of the statuses),
  • done (status done),
  • final (statuses done, cancel),
  • all (all statuses)

Enum: "none" "done" "final" "all"
autoredirect_from_status_page_in_seconds
integer

Time (in seconds) before autoredirect.

status_page_show_return_to_game_link
string

Status for a manual redirect. Possible values:

  • none (none of the statuses),
  • done (status done),
  • final (statuses done, cancel),
  • virtual_operation (payment status with virtual currency),
  • all (all statuses).

Enum: "none" "done" "final" "virtual_operation" "all"
object

Localized redirect button captions.

descriptor
string

Short project name for reports (up to 12 characters).

locale_list
Array of strings

List of languages that corresponding settings are localized to.

object

Localized project names.

url
string

Project website URL.

description
string

Array of localized project descriptions.

object

Project modules.

img
string
object
xsolla_tips_enabled
string
Enum: "none" "xsolla" "project"
Array of objects
integration_type
string

Project integration type.

Enum: "standard" "tokenless" "simplified" "play_fab"
Responses
201

Created.

404

Not Found.

Request samples
application/json
{
  • "payment_url": "string",
  • "key": "string",
  • "return_url": "string",
  • "user_billing_enabled": true,
  • "show_user_in_paystation": true,
  • "user_public_id_enabled": true,
  • "is_external_id_required": true,
  • "ipn_enabled": true,
  • "is_universal_item_enabled": true,
  • "send_email_for_user_billing_purchase": true,
  • "autoredirect_from_status_page": "none",
  • "autoredirect_from_status_page_in_seconds": 0,
  • "status_page_show_return_to_game_link": "none",
  • "status_page_return_to_game_link_name": {
    },
  • "descriptor": "string",
  • "locale_list": [
    ],
  • "name": {
    },
  • "url": "string",
  • "description": "string",
  • "components": {
    },
  • "img": "string",
  • "secondary_market": {
    },
  • "xsolla_tips_enabled": "none",
  • "xsolla_tips_settings": [
    ],
  • "integration_type": "standard"
}