Itens gratuitos
Como funciona
Itens grátis são um tipo de item que o usuário pode obter sem gastar moedas virtuais ou reais. Estes incluem:
- Itens virtuais
- Conjuntos
- Pacotes de moedas virtuais
Os itens grátis estão disponíveis apenas para usuários autorizados. Usuários não autorizados só podem visualizar o catálogo de itens grátis.
Exemplos de uso:
- Você pode dar itens grátis em datas importantes para o seu projeto (por exemplo, no dia em que o projeto foi fundado) para recompensar os usuários por sua lealdade.
- Você pode presentear pacotes de iniciante grátis do jogo na loja para atrair novos usuários ao jogo.
Você pode limitar a quantidade grátis de itens exclusivos caso o usuário já os possuam.
Quem pode usar
- Para parceiros que já têm a In-Game Store e querem configurar um novo tipo de produto — itens gratuitos.
- Para parceiros que desejam aumentar a fidelidade dos usuários atuais ou atrair novos jogadores.
Fluxo de integração
- Crie itens gratuitos das seguintes maneiras:
- Configure a Store.
- Obtenha o status do pedido de um usuário.
Criar via Conta de Distribuidor
Para criar um item gratuito (com base no exemplo de itens virtuais):- Abra seu projeto na Conta de Distribuidor.
- Clique em Store no menu lateral.
- No painel Virtual Items, clique em Configure.
- Clique em + e selecione Create item na lista suspensa.
- Especifique:
- Imagem
- SKU
- Um ou vários grupos aos quais o item deve pertencer
- Nome
- Descrição
- Propriedade de item: consumível, não consumível ou item de tempo limitado
- No bloco Price settings, escolha Free item.
- Se você quiser limitar a disponibilidade de itens a usuários específicos, defina a opção Limit number of times one user can buy this item como On.
- Se você quiser mostrar um item na loja, defina a opção Show item in store como On.
- Clique em Create item.
Criar via chamadas de API
- Para criar itens gratuitos, use chamadas de API da subseção Admin:
- Para itens virtuais — Create virtual item
- Paca pacotes de moedas — Create virtual currency package
- Para conjuntos — Create bundle
is_free = true
no corpo da solicitação. - Se você quiser limitar a disponibilidade de itens para usuários específicos, chame qualquer método de API para criar ou editar um item e especifique o valor do parâmetro
limits.per_user
.
Configurar a Store
Compra rápida
Se um usuário fizer uma compra rápida (o usuário faz uma compra sem usar o carrinho), você deve chamar a API Create order with specified free item para fornecer a oportunidade de receber itens grátis. A entrega dos itens ao inventário do usuário ocorre imediatamente após uma solicitação bem-sucedida a esse método (sem ser necessário abrir o formulário de pagamentodo Pay Station). A Xsolla envia um webhook Successful payment of the order para confirmar a entrega do item.Observação
O envio do webhook Successful payment of the order ocorre imediatamente após a entrega dos itens grátis. Nesse caso, o webhook Pagamento não é enviado.
Copy
- http
{
"method": "POST",
"url": "https://mybestgame.com/xsolla/notification",
"body": {
"items": [
{
"sku": "gift_direct_game_reward-supercoin",
"type": "virtual_currency",
"is_pre_order": false,
"quantity": 500,
"amount": "0",
"promotions": [
]
},
{
"sku": "package-500_supercoin",
"type": "bundle",
"is_pre_order": false,
"quantity": 1,
"amount": "0",
"promotions": [
]
},
{
"sku": "xsolla-giveaway_offer_11_14_22",
"type": "bundle",
"is_pre_order": false,
"quantity": 1,
"amount": "0",
"promotions": [
]
}
],
"notification_type": "order_paid",
"order": {
"id": 12345678,
"mode": "default",
"currency_type": "unknown",
"currency": null,
"amount": "0",
"status": "paid",
"platform": "xsolla",
"comment": null,
"invoice_id": null,
"promotions": [
]
},
"user": {
"external_id": "1234567812345678",
"email": null
}
},
"headers": {
"Authorization": "Signature 3b840ccefea111dcdfd111db1fdc6df969a3ec11",
"Accept": "application/json",
"Content-Type": "application/json"
},
"type": "webhook_payment",
"callback_parameters": {
"order_id": 12345678
}
}
Observação
Para itens gratuitos, o parâmetro order.invoice_id é definido como
null
.- Se o ouvinte aceitou e processou corretamente o webhook — código de resposta HTTP 200 ou 204.
- Se o erro esperado ocorrer — código de resposta HTTP 4xx.
- Seu ouvinte também pode retornar um código de resposta HTTP 5xx para erros temporários em seu servidor. Nesse caso, o serviço de alerta Xsolla usa um mecanismo de repetição.
Observação
Neste caso, os itens são adicionados ao inventário do jogador e a ordem é marcada como bem-sucedida do lado da Xsolla.
Compra no carrinho
Se um usuário usar a compra de carrinho:
- Se o carrinho do usuário contiver itens pagos e gratuitos, chame o método API Create order with all items from particular cart e Create order with all items from current cart atual para criar pedidos. Os usuários efetuarão o pagamento do pedido através do formulário de pagamento Pay Station.
- Se o carrinho do usuário contiver apenas itens gratuitos, chame a API Create order with free cart e Create order with particular free cart para obter um carrinho gratuito. Neste caso, a interface de pagamento não será usada.
O exemplo de webhook é semelhante ao exemplo de compra rápida.
Este artigo foi útil?
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.