/api-php-picpay

Adaptação da API do PicPay para dev's PHP.

Primary LanguagePHP

Logo-PicPay
API PICPAY PARA PHP 💚

🚀 Criei essa adaptação da API do PicPay para pessoas que desejam utilizar o gateway de pagamento de uma forma simples e rápida em seus sites/sistemas que utilizam PHP.

Como usarRequisitosInstalaçãoDocumentaçãoAutor


🎲 Como utilizar?

▪️ Para utilizar o projeto, você precisa baixar/clonar o repositório nos arquivos do seu site/sistema;

▪️ Após realizar o download/clone do repositório, realize as configurações exigidas para o funcionamento;

▪️ Feito os passos anteriores, agora é hora de colocar para funcionar. Para isso, vá no arquivo que você está utilizando como base para envio das informações (fora da pasta PicPay) e inclua o autoload.php;

Codigo PHP

▪️ Com o autoload incluso, você deverá instânciar a classe de venda, passando alguns parâmetros por ela, e logo após chamar a função de envio. Caso seja enviado com sucesso, o comprador será redirecionado automaticamente;

Codigo PHP

▪️ Para realizar cancelamentos de compras, você precisa instânciar a classe de cancelamento e passar alguns parâmetros para ela.

Codigo PHP

*Obs: Se você preencheu todas as configurações corretamente, esses são os únicos comandos necessários!


⚙️ Requisitos

▪️ O sistema precisa estar hospedado na web para receber as notificações de atualização de status do PicPay;

▪️ A empresa deve estar registrada no Painel de Lojistas PicPay;

▪️ É necessário pegar os códigos x_picpay_token e x_seller_token no Painel de Lojistas.


⌛️ Instalação

▪️ Download direto:
Clique para baixar

▪️ Git Clone:
$ git clone https://github.com/vitorlbarroso/api-php-picpay


🧩 Documentação

▪️ Ao baixar/clonar o repositório, você precisa fazer algumas configurações para que possa enviar os dados para o PicPay;

▪️ Para preencher as informações necessárias, você precisa estar com os códigos x_picpay_token e x_seller_token em mãos. Ambos podem ser pegos no Painel de Lojistas PicPay;


▪️ Já com o repositório aberto em seu editor de códigos, abra os arquivos ConfigPicPay.class.php e UpdateDataBase.class.php, localizados na pasta PicPay;

▪️ Preencha as informações seguindo a documentação:


🔺 ConfigPicPay.class.php


- Chaves PicPay:

1. Chave para enviar informações do e-commerce ao PicPay;

2. Chave para receber os callbacks do PicPay

Codigo PHP

- Links do site/sistema:

1. Link que recebe a notificação - https://SEUSITE.COM/DIRETORIO/PicPay/GetStatusPicPay.class.php;

2. Link para onde onde será redirecionado ao finalir a compra - https://SEUSITE.COM/;

Codigo PHP

- Nosso método de inclusão:

1. Sim - Continue configurando;

2. Nao - Pule para a configuração do UpdateDataBase.class.php;

Obs: Esse método só é válido para quem utiliza o PDO. Codigo PHP

- Se escolheu nosso método:

1. Crie uma tabela no seu B.D com as colunas abaixo citadas;

2. Preencha de acordo com o nome das colunas da sua tabela:

Codigo PHP

🔺 UpdateDataBase.class.php


- Incluir o seu B.D:

1. Linha #11;

2. Linha #60;

Codigo PHP

- Criar suas querys:

1. Linha #51

2. Linha #79

Obs: Só siga esses passos se você estiver utilizando o método de inclusão próprio!

Codigo PHP


🔺 Arquivo de Instância


▪️ Inclua o arquivo autoload e instancie a classe de venda, passando os parâmetros solicitados;

Codigo PHP

▪️ Para realizar cancelamentos de compras, você precisa instânciar a classe de cancelamento e passar alguns parâmetros para ela.

Codigo PHP



Foto-Autor-Vitor-Barroso
Vitor Barroso 👻

Desenvolvedor Web - Apaixonado por programação 🤓