# iHubGames — API

> Gateway de pagamentos. Cash-in em BRL (PIX / Cartão / Boleto / Pix ou Boleto), MXN (SPEI / OXXO), ARS (Bank Transfer), COP (PSE / Nequi / Bre-B), BOB (QR), faturas, assinaturas e checkouts hospedados. Valores da API pública em **centavos**.

Saque é sempre em BRL, por PIX: não há cash-out nas moedas estrangeiras. O saldo recebido em moeda local é liquidado para BRL pela plataforma — o cliente não solicita nem aprova a conversão — e só então fica disponível para saque.

Autenticação por API key no header. Ambientes LIVE e TEST são isolados: uma chave TEST nunca move dinheiro real.

## Guias por caso de uso

### Por onde começar

- [Ambiente de testes (Sandbox)](https://dashboard.ihubplay.com/docs/sandbox-guide)
- [Pagamentos via API](https://dashboard.ihubplay.com/docs/api-payments-guide)
- [Catálogo e Assinaturas](https://dashboard.ihubplay.com/docs/saas-guide)

## Webhooks

### Visão geral

- [Webhooks](https://dashboard.ihubplay.com/docs/webhooks-overview)

### Segurança

- [Verificação de assinatura](https://dashboard.ihubplay.com/docs/signature-key)

### Configuração

- [Escolhendo uma versão](https://dashboard.ihubplay.com/docs/webhook-configuration)
- [Payload v1 (legado)](https://dashboard.ihubplay.com/docs/webhook-v1)
- [Payload v2 (atual)](https://dashboard.ihubplay.com/docs/webhook-v2)

## Referência da API

### Conceitos

- [Autenticação e chaves](https://dashboard.ihubplay.com/docs/authentication)
- [Trace ID e debug](https://dashboard.ihubplay.com/docs/x-trace-id)
- [Status de transações e saques](https://dashboard.ihubplay.com/docs/status-reference)
- [Ambiente de testes (Sandbox)](https://dashboard.ihubplay.com/docs/sandbox-guide)

### Moedas

- [Métodos por moeda](https://dashboard.ihubplay.com/docs/payment-methods)
- [🇧🇷 Brasil](https://dashboard.ihubplay.com/docs/brl-pix-overview)
- [🇲🇽 México](https://dashboard.ihubplay.com/docs/mxn-spei)
- [🇦🇷 Argentina](https://dashboard.ihubplay.com/docs/ars-transfer)
- [🇨🇴 Colômbia](https://dashboard.ihubplay.com/docs/cop-transfer)
- [🇧🇴 Bolívia](https://dashboard.ihubplay.com/docs/bob-qr)

### Conta

- [`GET` Listar contas de recebimento](https://dashboard.ihubplay.com/docs/api/list-receiver-accounts)
- [`POST` Gerar conta de recebimento](https://dashboard.ihubplay.com/docs/api/create-receiver-account)
- [`DELETE` Remover conta de recebimento](https://dashboard.ihubplay.com/docs/api/delete-receiver-account)
- [`GET` Consultar saldo](https://dashboard.ihubplay.com/docs/api/get-balance)
- [`GET` Consultar saldo por moeda](https://dashboard.ihubplay.com/docs/api/get-balances)
- [`GET` Liquidações de câmbio](https://dashboard.ihubplay.com/docs/api/get-conversions)
- [`GET` Conferir conta de destino](https://dashboard.ihubplay.com/docs/api/resolve-internal-transfer)
- [`POST` Transferência interna](https://dashboard.ihubplay.com/docs/api/create-internal-transfer)

### Transações

- [Cartão (Visão Geral)](https://dashboard.ihubplay.com/docs/card-overview)
- [`GET` Buscar transação](https://dashboard.ihubplay.com/docs/api/get-transaction)
- [`POST` Estornar transação](https://dashboard.ihubplay.com/docs/api/refund-transaction)
- [`POST` Criar transação (BRL)](https://dashboard.ihubplay.com/docs/api/create-transaction)
- [`POST` Criar transação (MXN)](https://dashboard.ihubplay.com/docs/api/create-transaction-mxn)
- [`POST` Criar transação (ARS)](https://dashboard.ihubplay.com/docs/api/create-transaction-ars)
- [`POST` Criar transação (COP)](https://dashboard.ihubplay.com/docs/api/create-transaction-cop)
- [`POST` Criar transação (BOB)](https://dashboard.ihubplay.com/docs/api/create-transaction-bob)
- [`POST` Criar transação (Cartão — token)](https://dashboard.ihubplay.com/docs/api/create-transaction-card-token)
- [`POST` Criar transação (Cartão — PAN)](https://dashboard.ihubplay.com/docs/api/create-transaction-card-pan)
- [`POST` Criar transação (Boleto)](https://dashboard.ihubplay.com/docs/api/create-transaction-boleto)
- [`POST` Criar transação (Pix ou Boleto)](https://dashboard.ihubplay.com/docs/api/create-transaction-pix-boleto)
- [`GET` Config de cartão](https://dashboard.ihubplay.com/docs/api/card-config)

### Saques

- [`POST` Saque por chave PIX](https://dashboard.ihubplay.com/docs/api/cashout-pix-key)
- [`POST` Saque por QR Code](https://dashboard.ihubplay.com/docs/api/cashout-qrcode)
- [`GET` Buscar saque](https://dashboard.ihubplay.com/docs/api/get-withdraw)

### Clientes

- [`POST` Criar cliente](https://dashboard.ihubplay.com/docs/api/create-customer)
- [`GET` Listar clientes](https://dashboard.ihubplay.com/docs/api/list-customers)
- [`GET` Buscar cliente](https://dashboard.ihubplay.com/docs/api/get-customer)
- [`PATCH` Atualizar cliente](https://dashboard.ihubplay.com/docs/api/update-customer)
- [`DELETE` Deletar cliente](https://dashboard.ihubplay.com/docs/api/delete-customer)
- [`GET` Histórico do cliente](https://dashboard.ihubplay.com/docs/api/customer-history)

### Cupons

- [Visão geral](https://dashboard.ihubplay.com/docs/coupons-overview)
- [`POST` Criar cupom](https://dashboard.ihubplay.com/docs/api/create-coupon)
- [`GET` Listar cupons](https://dashboard.ihubplay.com/docs/api/list-coupons)
- [`GET` Buscar cupom](https://dashboard.ihubplay.com/docs/api/get-coupon)
- [`PATCH` Atualizar cupom](https://dashboard.ihubplay.com/docs/api/update-coupon)
- [`POST` Pausar cupom](https://dashboard.ihubplay.com/docs/api/pause-coupon)
- [`POST` Retomar cupom](https://dashboard.ihubplay.com/docs/api/resume-coupon)
- [`DELETE` Arquivar cupom](https://dashboard.ihubplay.com/docs/api/archive-coupon)
- [`GET` Listar usos](https://dashboard.ihubplay.com/docs/api/list-redemptions)
- [`POST` Adicionar ofertas à whitelist](https://dashboard.ihubplay.com/docs/api/add-coupon-offers)
- [`DELETE` Remover oferta da whitelist](https://dashboard.ihubplay.com/docs/api/remove-coupon-offer)

### Produtos

- [Visão geral](https://dashboard.ihubplay.com/docs/products-offers-overview)
- [`POST` Criar produto](https://dashboard.ihubplay.com/docs/api/create-product)
- [`GET` Listar produtos](https://dashboard.ihubplay.com/docs/api/list-products)
- [`GET` Buscar produto](https://dashboard.ihubplay.com/docs/api/get-product)
- [`PATCH` Atualizar produto](https://dashboard.ihubplay.com/docs/api/update-product)
- [`DELETE` Deletar produto](https://dashboard.ihubplay.com/docs/api/delete-product)
- [`GET` Ofertas do produto](https://dashboard.ihubplay.com/docs/api/list-product-offers)
- [`POST` Upload de imagem](https://dashboard.ihubplay.com/docs/api/upload-product-image)
- [`DELETE` Remover imagem](https://dashboard.ihubplay.com/docs/api/delete-product-image)

### Ofertas

- [`POST` Criar oferta](https://dashboard.ihubplay.com/docs/api/create-offer)
- [`GET` Listar ofertas](https://dashboard.ihubplay.com/docs/api/list-offers)
- [`GET` Buscar oferta](https://dashboard.ihubplay.com/docs/api/get-offer)
- [`PATCH` Atualizar oferta](https://dashboard.ihubplay.com/docs/api/update-offer)
- [`DELETE` Deletar oferta](https://dashboard.ihubplay.com/docs/api/delete-offer)
- [`POST` Upload de PDF](https://dashboard.ihubplay.com/docs/api/upload-offer-pdf)
- [`DELETE` Remover PDF](https://dashboard.ihubplay.com/docs/api/delete-offer-pdf)

### Links de pagamento

- [Personalizar o checkout](https://dashboard.ihubplay.com/docs/checkout-customization)
- [Visão geral](https://dashboard.ihubplay.com/docs/quick-links-overview)
- [`POST` Criar link](https://dashboard.ihubplay.com/docs/api/create-quick-link)
- [`GET` Listar links](https://dashboard.ihubplay.com/docs/api/list-quick-links)
- [`GET` Buscar link](https://dashboard.ihubplay.com/docs/api/get-quick-link)
- [`GET` Transações do link](https://dashboard.ihubplay.com/docs/api/list-quick-link-transactions)
- [`PATCH` Atualizar link](https://dashboard.ihubplay.com/docs/api/update-quick-link)
- [`POST` Pausar link](https://dashboard.ihubplay.com/docs/api/pause-quick-link)
- [`POST` Retomar link](https://dashboard.ihubplay.com/docs/api/resume-quick-link)
- [`POST` Duplicar link](https://dashboard.ihubplay.com/docs/api/duplicate-quick-link)
- [`DELETE` Arquivar link](https://dashboard.ihubplay.com/docs/api/archive-quick-link)

### Assinaturas

- [Visão geral](https://dashboard.ihubplay.com/docs/subscriptions-overview)
- [`POST` Criar assinatura](https://dashboard.ihubplay.com/docs/api/create-subscription)
- [`GET` Listar assinaturas](https://dashboard.ihubplay.com/docs/api/list-subscriptions)
- [`GET` Buscar assinatura](https://dashboard.ihubplay.com/docs/api/get-subscription)
- [`GET` Invoices da assinatura](https://dashboard.ihubplay.com/docs/api/list-subscription-invoices)
- [`PATCH` Atualizar assinatura](https://dashboard.ihubplay.com/docs/api/update-subscription)
- [`POST` Pausar assinatura](https://dashboard.ihubplay.com/docs/api/pause-subscription)
- [`POST` Retomar assinatura](https://dashboard.ihubplay.com/docs/api/resume-subscription)
- [`POST` Cancelar assinatura](https://dashboard.ihubplay.com/docs/api/cancel-subscription)

### Faturas

- [Visão geral](https://dashboard.ihubplay.com/docs/invoices-overview)
- [`POST` Criar fatura](https://dashboard.ihubplay.com/docs/api/create-invoice)
- [`GET` Listar faturas](https://dashboard.ihubplay.com/docs/api/list-invoices)
- [`GET` Buscar fatura](https://dashboard.ihubplay.com/docs/api/get-invoice)
- [`PATCH` Atualizar fatura](https://dashboard.ihubplay.com/docs/api/update-invoice)
- [`POST` Cancelar fatura](https://dashboard.ihubplay.com/docs/api/cancel-invoice)
- [`POST` Reenviar notificação](https://dashboard.ihubplay.com/docs/api/resend-invoice-notification)
- [`GET` Métricas](https://dashboard.ihubplay.com/docs/api/invoice-metrics)

### Webhooks

- [`GET` Listar webhooks](https://dashboard.ihubplay.com/docs/api/list-webhooks)
- [`POST` Criar webhook](https://dashboard.ihubplay.com/docs/api/create-webhook)
- [`PATCH` Atualizar webhook](https://dashboard.ihubplay.com/docs/api/update-webhook)
- [`DELETE` Deletar webhook](https://dashboard.ihubplay.com/docs/api/delete-webhook)
- [`POST` Rotacionar secret](https://dashboard.ihubplay.com/docs/api/rotate-webhook-secret)
- [`POST` Enviar evento de teste](https://dashboard.ihubplay.com/docs/api/test-webhook)
- [`GET` Listar entregas](https://dashboard.ihubplay.com/docs/api/list-webhook-deliveries)
- [`GET` Métricas](https://dashboard.ihubplay.com/docs/api/webhook-metrics)

## Referência completa

- [Documentação inteira em texto](https://portal.ihubplay.com/llms-full.txt) — 87 endpoints com parâmetros, exemplos e respostas.