Download the PHP package misterioso013/picpay-php without Composer
On this page you can find all versions of the php package misterioso013/picpay-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download misterioso013/picpay-php
More information about misterioso013/picpay-php
Files in misterioso013/picpay-php
Package picpay-php
Short Description Integração simples com a API do PicPay
License MIT
Homepage https://github.com/misterioso013/picpay-php
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 picpay-php
Receba Pagamentos via PicPay
Vamos utilizar a API do PicPay E-commerce para receber pagamentos em nosso sistema simples criado com PHP 8.
Instalação
Inclua o arquivo PicPay.php no código:
Ou utilize o composer para facilitar a sua vida. Instalação:
Exemplo de uso:
Atenção: Lembre-se de substituir x_picpay_token e x_seller_token pelos seus token encontrados no site do PicPay.
Solicitar Pagamentos
O cliente decide pagar usando o PicPay e agora é só gerar o pagamento com os dados dele. Teste o código:
Entenda a resposta
Ao solicitar o pagamento você recebe um Array com os seguintes dados:
| Índice/Chave | Descrição |
|---|---|
| referenceId | Irá retornar o ID que você definiu anteriormente |
| paymentUrl | URL da página onde o cliente faz o pagamento e depois é redirecionado para returnUrl |
| qrcode | Chave de Array com content e base64 |
| qrcode->content | Conteúdo do QR Code. Poder ser útil para criar o seu próprio QR |
| qrcode->base64 | A imagem do QR code em Base64 |
| expiresAt | Data da expiração do pedido em ISO 8601 que foi definida anteriormente |
Erros
Os erros irão retornar as seguintes mensagens:
- O Token informado é inválido
- Algumas propriedades não passaram no teste de validação.
- Problema geral, verifique se a transação foi criada ou cancele a mesma.
Esperar por erros ajuda a não depender apenas do cliente definir digitar os dados corretamente ou da API que você está usando. Aconteça o que acontecer mas seu sistema nunca cairá por causa de algum erro.
Erro 422 - Validação de Dados
Resposta à possíveis erros:
Exemplo de como verificar esses erros:
Status
Consulte o status do seu pedido de forma simples. Use nosso exemplo para melhor compreensão
Use o
referenceIdcomo indetificador do pedido
Exemplo:
Retorno em caso de sucesso:
Entenda o Array acima:
| Índice/Chave | Descrição |
|---|---|
| referenceId | Irá retornar o ID que você definiu anteriormente |
| status | Status atual do pedido |
| createdAt | Data da criação do pedido em ISO 8601 |
| updatedAt | Data da última atualização de status do pedido em ISO 8601 |
| value | Preço do pedido |
| authorizationId | Número da autorização de pagamento (caso esteja pago) |
Possíveis status:
| Status | Descrição |
|---|---|
| created | registro criado |
| expired | prazo para pagamento expirado |
| analysis | pago e em processo de análise anti-fraude |
| paid | pago |
| completed | pago e saldo disponível |
| refunded | pago e devolvido |
| chargeback | pago e com chargeback |
Cancelamento
Cancele pedidos que ainda não foram pagos ou devolva o dinheiro de pagamentos já concluídos.
Use o
referenceIdcomo indetificador do pedido Use oauthorizationIdpara cancelar pedidos que já estão pagos
Exemplo:
Retorno em caso de sucesso:
Entenda o Array acima:
| Índice/Chave | Descrição |
|---|---|
| referenceId | Irá retornar o ID que você definiu anteriormente |
| cancellationId | Número de verificação do cancelamento do pagamento |
Não pude testar tudo que é possível acontecer com o uso da API, e a sua última documentação se encontra fora de funcionamento no momento desse commit.
Sinta-se a vontade para fazer um fork e continuar esse projeto, tenho certeza que isso ajudará muita gente.
