Saldo do usuário: resgatar cupom

Xsolla Developers

Conta de Distribuidor

Saldo do usuário: resgatar cupomWebhook POST

Enviado quando um usuário resgata um cupom para receber itens virtuais ou moedas virtuais.

Request

Request Body schema: application/json

object

Dados do cupom (objeto).

campaign_code	string Código da campanha.
coupon_code	string Código de cupom.

id_operation

integer

ID de operação no banco de dados Xsolla.

items

Array of objects

Itens virtuais dentro da compra.

items_operation_type

string

Tipo de operação feita com itens virtuais.

notification_type

string

Tipo de notificação.

operation_type

string

Tipo de operaçã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.

object

Dados do usuário (objeto).

id required	string ID de usuário.
email	string E-mail do usuário.
name	string Nome de usuário.

object

Dados de saldo do usuário (objeto).

diff	string Quantidade de moedas virtuais na compra.
new_value	string Saldo após transação.
old_value	string Saldo antes da transação.

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 '{
        "settings": {
            "project_id": 18404,
            "merchant_id": 2340
        },
        "virtual_currency_balance": {
            "old_value": "0",
            "new_value": "0",
            "diff": "0"
        },
        "user": {
            "name": "Xsolla User",
            "id": "1234567",
            "email": "email@example.com"
        },
        "operation_type": "coupon",
        "notification_type": "user_balance_operation",
        "items_operation_type": "add",
            "items": [{
                "sku": "com.xsolla.item_1468",
                "amount": "2"
            }],
        "id_operation": "66989",
        "coupon": {
            "coupon_code": "test123",
            "campaign_code": "Xsolla Campaign"
        }
    }'

Response samples

application/json

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