Ativar chave

Xsolla Developers

Conta de Distribuidor

Ativar chaveWebhook POST

Quando um usuário ativa uma chave, o Xsolla envia uma notificação para o URL do webhook.

Request

Request Body schema: application/json

activation_date

string <datetime>

Data de ativação da chave no formato YYYYMMDDHHMMSS de acordo com o ISO 8601.

key

string

Chave de ativação.

notification_type

string

Tipo de notificação.

object

Objeto com configurações de cluster de restrição regional. O cluster inclui um tipo de restrição e uma lista de países, servidores e localidades para os quais o jogo está disponível.

countries	Array of strings Matriz de países no cluster.
locales	Array of strings Matriz de localidades.
name	string Nome do cluster.
servers	Array of strings Matriz de servidores de jogos.
sku	string ID de cluster exclusivo.
types	Array of strings Matriz de tipos de restrição.

object

Configurações personalizadas do projeto (objeto).

merchant_id	integer ID de comerciante.
project_id	integer ID do projeto. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto.

sku

string

ID do pacote de chaves único.

user_country

string

País do usuário. Código de país de duas letras maiúsculas, de acordo com o ISO 3166-1 alpha-2.

user_id

string

ID de usuário.

Responses

204

Retorne para indicar o processamento bem-sucedido.

400

Retorne em caso de erro nas informações fornecidas (por exemplo, um parâmetro obrigatório ausente, falha na autorização, etc.).

500

Retorne para indicar erros temporários com seus servidores.

Request samples

CURL
PHP
HTTP

curl -v 'https://your.hostname/your/uri' \
-X POST \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-H 'authorization: Signature 13342703ccaca5064ad33ba451d800c5e823db8f' \
-d '{
  "notification_type": "redeem_key",
  "settings": {
        "project_id": 18404,
        "merchant_id": 2340
  },
  "key": "wqdqwwddq9099022",
  "sku": "com.xsolla.key_123",
  "user_id": "sample_user",
  "activation_date": "2018-11-20T08:38:51+03:00",
  "user_country": "EN",
  "restriction": {
      "name": "cls_1",
      "types": [
          "activation"
        ],
        "countries": [
            "RU"
        ]
    }
}'

Response samples

application/json

{"error": {"code": "INCORRECT_AMOUNT",
"message": "Incorrect amount"
}
}