/python-picpay

Primary LanguagePythonMIT LicenseMIT

Build Status GitHub GitHub top language Coveralls github branch GitHub All Releases GitHub issues

Python Picpay

Python-Picpay é um package (pacote) que integra bem com a api do picpay. Com este pacote, podemos criar facilmente pagamentos, cancelá-los e sermos notificados quando houver uma mudança no status do pagamento.

Instalação

Para instalar o python-picpay é muito fácil, pois, ele está localizado no Pypi. Para instalar você pode executar o seguinte comando em seu terminal:

$ pip install python-picpay

Como usar

Antes de começar, você deve importar a class Picpay veja:

from python_picpay import Picpay

Agora, você pode compor os dados do envio do pagamento, veja:

payment_data = {
	"referenceId": "21144", # código do produto
	"callbackUrl": "https://seusite.com.br/callback",
	"returnUrl": "https://spacedevs.com.br/cliente/pedido/21144", 
	"value": 99.90, # preço do produto
	"expiresAt": "2022-05-01T16:00:00-03:00",
	"buyer": {
		"firstName": "Jose", # primeiro nome do comprador
		"lastName": "Santos", # sobrenome do comprador
		"document": "182.255.879-55", # cpf do comprador
		"email": "email_do_comprador@email.com",
		"phone": "+55 71 91111-1111",
	},
}

Atenção: Para entender melhor o que cada parâmetro desse significa, clique aqui para ver a documentação oficial do picpay.

Logo em seguida crie um token, este token é necessário para que a picpay saiba que você é realmente você. Para obter o token, acesse sua conta de lojista.

https://lojista.picpay.com/ecommerce-token

token = "seu_token"

E então, crie o pagamento...

picpay = Picpay(token)
response = picpay.payment(payment_data)

Você pode ver a resposta da requisição dando um print no response:

print(response)`

Testando a biblioteca

Para testar a biblioteca, dentro do mesmo diretório do projeto execute o comando:

$ make test

Screenshots

Pagamento realizado com sucesso

paid

Lista de vendas

payments list

Estorno da venda

refound