Todo erro da API vem com um código curto e uma mensagem clara. Estes são os que os comerciantes mais encontram.
Credenciais e acesso
- unauthenticated / invalid_credentials: a chave do projeto ou o segredo está faltando ou errado. Procure espaços sobrando e confira se o segredo é deste projeto.
- project_inactive: você usou o segredo live antes de o projeto ser aprovado. Até lá, use o segredo de teste, veja Análise do projeto: o que verificamos.
- project_disabled: o projeto está suspenso ou não foi aprovado.
- ip_not_allowed: a chamada veio de um endereço que não está na lista de IPs permitidos na API do projeto.
A sua requisição
- invalid_request: falta um campo ou ele está no formato errado. A mensagem diz qual é o campo.
- duplicate_order_id: já existe um pagamento com esse order ID neste modo. Use um novo ou consulte o pagamento existente.
- insufficient_funds: o saldo não basta para uma compra de skin. A mensagem diz quanto é necessário.
Limites de taxa
Um projeto pode fazer até 600 chamadas por minuto. Acima disso você recebe rate_limited com uma indicação de quando tentar de novo. Espere em vez de repetir num loop apertado.
Quando o mercado está lento
Se a rede de pagamentos não responder, você recebe uma mensagem pedindo para tentar de novo em um minuto. Order IDs e custom IDs são únicos por projeto, então uma nova tentativa nunca cria um segundo pagamento ou uma segunda compra. Repetir uma chamada de compra com o mesmo custom ID retorna a compra existente.
A lista completa de erros, campos e exemplos está na referência da API.