Download the PHP package radardata/sdk-php without Composer
On this page you can find all versions of the php package radardata/sdk-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package sdk-php
RadarData SDK para PHP
SDK oficial do RadarData para PHP 8.2+, com
integração pronta para Laravel. Embrulha a API pública (/api/v2): consultas,
Verify (verificação de identidade), Motor de Análises e webhooks.
A API continua disponível para quem preferir chamá-la direto. Este pacote existe para você não precisar.
Começando
O token é o token de API, criado no painel, e não o da sua sessão do
painel. Ele carrega escopos (consultas, verify, analises, leitura,
webhooks): uma chamada fora do escopo volta SemEscopo.
Laravel
O pacote se registra sozinho. Publique a config se quiser editá-la:
Seus proprios fluxos de analise
Da para montar o pipeline por codigo, em vez de desenha-lo no painel: voce
manda a definicao inteira num array e recebe um fluxo publicado, pronto para
rodar com analises()->criar().
Duas coisas que valem saber antes:
- O preco nao vai no pedido. Ele e calculado pelas bases que o fluxo
consulta, com a tabela da sua conta, e cobra o caminho mais caro. Chame
validar()antes de publicar para ver o numero. - Escopo
fluxos, separado deanalises. Publicar fluxo escolhe o que e consultado e que regra reprova alguem. Use um token de provisionamento aqui, e deixe o token do dia a dia so comanalises.
Publicar e idempotente pelo conteudo: mandar a mesma definicao de novo nao cria versao nova, entao da para chamar isto a cada deploy.
Consultas
Gasta saldo. O retorno vem como array porque cada serviço devolve um corpo diferente e a lista cresce: tipar tudo aqui faria o SDK desatualizar a cada serviço novo sem ninguém perceber.
Para saber o que a sua conta pode consultar, e por quanto:
Verify
O resultado chega por webhook. Dá para consultar também:
Criar sessão não é idempotente. Se der timeout, não chame de novo às cegas: você pagaria duas sessões. Mande um
reference_idseu e procure por ele antes de criar outra.
Análises
Assíncrono: criar devolve o id, o resultado chega por webhook.
Webhooks: conferir que o aviso é nosso
Três coisas que costumam dar errado aqui, e valem a leitura:
Use o corpo cru. $request->getContent(), não o array decodificado.
Reserializar muda espaços e ordem das chaves, o HMAC muda junto e a conferência
falha sem motivo aparente. É o erro mais comum de qualquer integração deste
tipo, e há um teste neste repositório que o demonstra.
Deduplique pelo X-RadarData-Delivery. Reenviamos quando a entrega falha,
então o mesmo evento pode chegar duas vezes.
A assinatura prova origem e conteúdo, não a hora. O timestamp e o id de entrega viajam em cabeçalho, fora do corpo assinado, então ela não protege contra o reenvio de um aviso antigo e autêntico por quem o tenha interceptado. A dedup acima é a defesa prática.
Erros
Cada situação tem a sua classe, para você não comparar strings:
| Classe | Quando |
|---|---|
NaoAutenticado |
401, token ausente, inválido ou revogado |
SaldoInsuficiente |
402, a conta não tem saldo para a operação |
SemEscopo |
403, o token não tem o escopo daquela rota |
NaoEncontrado |
404 |
EntradaInvalida |
422, veja ->corpo para os campos |
MuitasTentativas |
429 |
ErroDoServidor |
5xx, falha nossa |
FalhaDeRede |
sem resposta: timeout, DNS, conexão recusada |
Todas estendem ErroRadarData, que traz ->codigo, ->status e ->corpo.
FalhaDeRede é separado de propósito: ali o SDK não sabe se a operação
aconteceu. Numa chamada que gasta saldo isso importa, e o caminho é consultar
pela mesma chave de idempotência, não repetir às cegas.
Repetição automática, e por que ela não é global
O SDK repete em 429 e 5xx somente nas chamadas em que manda
Idempotency-Key: consultas, análises e operações. A mesma chave faz a API
devolver a resposta anterior em vez de cobrar de novo.
Criar sessão de Verify não tem idempotência na API, então o SDK não repete ali, qualquer que seja a configuração. Repetir criaria uma segunda sessão faturável, e um SDK que cobra duas vezes do seu cliente é pior do que um SDK que devolve erro.
A chave é gerada automaticamente quando você não passa uma. Guarde a sua se quiser poder reconsultar o resultado depois de um timeout:
Apontando para outro ambiente
Desenvolvimento
Licença
MIT.
