Saltar para o conteúdo

Digital Distribution Hub (1.0.0)

Visão Geral

Digital Distribution Hub é uma nova solução Xsolla que visa conectar pagamentos digitais e baseados em dinheiro através da tecnologia de pagamentos push e e-commerce.

Essa referência combina pontos de extremidade de API para dois produtos Xsolla: In-Game Store e Pay Station. Há dois URLs base:

  • https://store.xsolla.com/api para os grupos Common, Catalog, Cart e Order.
  • https://ps.xsolla.com para o grupo Notifications.

Os pontos de extremidade da API no grupo Catalog não exigem autorização.

Para trabalhar com operações nos grupos Cart e Order, você precisa gerar um token via Create user token.

Observação

Esta referência mostra o design de uma API futura e não uma interface totalmente funcional. Atualmente, você pode experimentar apenas os pontos de extremidade dos grupos Catalog e Notifications. Se você quiser compartilhar seus comentários, envie um e-mail para techdoc@xsolla.com.
Transferir a descrição da OpenAPI
index.json
index.yaml
Idiomas
Servidores
Mock server
https://xsolla.redocly.app/_mock/pt/api/digital-distribution-hub/
https://store.xsolla.com/api/

Carrinho

Operações

Chaves de jogo

Operações

Itens virtuais e moeda

Operações

Conjuntos

Operações

Token de usuário

Operações

Notificações

Operações

Cancelar notificação

Pedido

Enviar a notificação sobre o cancelamento do pagamento se:

  • o pagamento não foi concluído
  • o pagamento foi reembolsado
Corpoapplication/json
payment_idintegerobrigatório
curl -i -X POST \
  https://xsolla.redocly.app/_mock/pt/api/digital-distribution-hub/push-payments/cancel \
  -H 'Content-Type: application/json' \
  -d '{
    "payment_id": 784998479
  }'

Respostas

OK.

Notificação de pagamento

Pedido

Envie esta notificação depois de cobrar um usuário com êxito.

Corpoapplication/json
paymentobjectobrigatório
payment.​amountnumberobrigatório

Valor do pagamento.

payment.​currencystring

Moeda do pedido. A moeda virtual usa o SKU e a moeda real usa um código de três letras do padrão ISO 4217.

payment.​geotype_idintegerobrigatório

ID do parceiro distribuidor do lado da Xsolla.

payment.​project_transaction_idstring

ID da transação do lado do desenvolvedor do jogo.

payment.​ps_transaction_idstring

ID da transação do lado do parceiro de distribuição.

project_idintegerobrigatório

ID do Projeto.

purchaseobjectobrigatório
purchase.​order_idintegerobrigatório

ID do Pedido.

userobjectobrigatório
user.​emailstring

Endereço de e-mail do usuário.

user.​idstringobrigatório

Identificador de usuário exclusivo no jogo.

user.​phonestring

Número de telefone do usuário.

user.​ps_account_idstring

ID da conta de pagamento do usuário do lado do parceiro de distribuição.

curl -i -X POST \
  https://xsolla.redocly.app/_mock/pt/api/digital-distribution-hub/push-payments/pay \
  -H 'Content-Type: application/json' \
  -d '{
    "payment": {
      "amount": 10,
      "currency": "USD",
      "geotype_id": 13038,
      "ps_transaction_id": "ps_transaction_id"
    },
    "project_id": 18404,
    "purchase": {
      "order_id": 1334430
    },
    "user": {
      "id": "s.ivanov"
    }
  }'

Respostas

OK.

Corpoapplication/json
payment_idinteger
Resposta
application/json
{
  "payment_id": 784998484
}

Pedido

Operações