FAQ técnicas

Registe uma conta e solicite uma chave de API à equipa da AhoraCrypto. A Payment Intent API requer adicionalmente um storeId, que é único por cliente e também é fornecido pela AhoraCrypto.

Todos os endpoints da API são servidos a partir de https://api.ahoracrypto.com.

Todos os pedidos devem incluir o cabeçalho x-api-key com a sua chave de API. Os pedidos sem uma chave válida devolvem 401 Unauthorized.

Consulte a página Redes para a lista completa. Utilize sempre o símbolo da rede exatamente como está listado aí como valor do campo network.

Qualquer um deles. Ao criar um Payment Intent, define o montante de crypto ou o montante de fiat, e o sistema calcula o outro. Se ambos forem enviados, o montante de fiat tem prioridade e o montante de crypto é recalculado.

Apenas quando o estado do Payment Intent é 4 (Pronto para pagar). Enquanto o estado não estiver pronto (por exemplo, se estiver pendente uma validação KYC), o endpoint de instruções não pode ser chamado. Verifique o estado a qualquer momento com o endpoint de estado.

Forneça um ipnUrl ao criar o Payment Intent. É chamado via GET com os parâmetros paymentIntentId e paymentIntentStatus sempre que o estado muda. Também pode consultar o endpoint de estado a qualquer momento.

Sim. Se um utilizador tiver de concluir o KYC antes de comprar, a chamada de criação devolve um kycUrl onde pode concluir a verificação. Forneça um kycCallbackUrl para trazer o utilizador de volta ao seu fluxo assim que o KYC estiver concluído.

O endereço IP faz parte dos dados enviados aos gateways de pagamento, que o exigem para verificar a autenticidade da transação. Quaisquer dados que forneça, como o país, devem ser precisos e nunca inferidos a partir de outros pontos de dados. Se um valor for desconhecido, omita-o.

Sim. Utilize o React SDK oficial (ahoracrypto-react-sdk), que também suporta Capacitor para criar aplicações iOS e Android. Para páginas web simples, utilize o Web Widget.