Na aba Pagamentos do painel você liga o PayPal que a loja do seu site já usa, para vender VIP, moedas, mobis e emblemas. Este guia mostra, passo a passo, onde conseguir o Client ID e o Secret — e como testar antes de receber dinheiro de verdade.
O dinheiro cai direto na sua conta PayPal: a loja é sua e o Habbo.Host não fica no meio do pagamento.
Antes de começar
- Você precisa de uma conta PayPal Business (empresa). Conta pessoal não gera credenciais de API.
- Vale testar tudo na sandbox (dinheiro de mentira) antes de ligar o live (dinheiro de verdade).
https://www.paypal.com/br/business
1. Crie o app na sandbox
- Entre no PayPal Developer com a sua conta e abra Apps & Credentials.
- Deixe o seletor em Sandbox.
- Clique em Create App, dê um nome (ex.: "Loja do hotel") e confirme.
- O app mostra o Client ID e o Secret. O Secret só aparece inteiro uma vez: se perder, gere outro.
https://developer.paypal.com/dashboard/applications/sandbox
O erro mais comum: a API usa o Client ID do app (uma sequência longa de letras e números, tipo AeA... ou sb-...). Não use o e-mail da conta nem o login de uma conta de teste. Quando alguém cola e-mail ou valor de exemplo, o PayPal responde "Authentication failed due to invalid authentication credentials" e a loja só mostra "algo deu errado".
2. Configure no painel
No painel, abra Configurar › Pagamentos › Checkout, clique na engrenagem do PayPal e preencha:
- Modo:
sandbox
- Moeda: a moeda da sua conta (ex.:
BRL, USD, EUR)
- Client ID (sandbox) e Client secret (sandbox)
Salve. O painel envia as credenciais para o site do hotel: quem processa o checkout é a própria CMS, usando a sua conta.
3. Teste com contas de teste
Na sandbox dá para criar contas de teste: uma pessoal (o comprador) e uma empresa (o vendedor). Entre no site do hotel com a conta pessoal de teste e compre um produto da loja.
https://developer.paypal.com/dashboard/accounts
4. Passe para o live
- Em Apps & Credentials, mude o seletor para Live e crie outro app.
- Copie o Client ID e o Secret de live.
- No painel, mude o Modo para
live e cole as credenciais de live.
https://developer.paypal.com/dashboard/applications/live
Erros mais comuns
- "Authentication failed..." → credenciais erradas ou de exemplo. Copie o Client ID e o Secret do app, não da conta.
- Modo e credenciais trocados →
sandbox com credencial live (ou o contrário) não autentica.
- Conta pessoal → sem permissão de API. Use uma conta Business.
- Pagou e não recebeu → o produto precisa ter itens ativos (emblema, mobi, moeda, cargo...) e o jogador precisa estar offline na hora da compra.
- Moeda recusada → confira a moeda da sua conta e a lista de moedas aceitas pelo PayPal.
https://developer.paypal.com/api/rest/reference/currency-codes/
Documentação oficial
https://developer.paypal.com/api/rest/
https://developer.paypal.com/api/rest/authentication/
https://developer.paypal.com/tools/sandbox/
https://github.com/srmklive/laravel-paypal
Ficou com dúvida? Responda aqui embaixo ou abra um ticket no painel — a gente ajuda a conferir a configuração.
📚 Leia também
