SDKs
SDKs oficiais para integrar com a API PayZu Pix sem precisar montar fetch na mão. Cobrem os 29 endpoints, Bearer Auth e tipagem completa dos schemas.
Instalação
npm install payzu-pixpip install payzu-pixDisponível a partir da versão 1.0.0 (será publicado no PyPI junto do release).
go get github.com/PayZuPlus/payzu-sdks/goEm breve. Depende da tag go/v1.0.0, criada no release.
PHP: em breve.
Uso
import { PayZu } from 'payzu-pix';
const payzu = new PayZu({ token: process.env.PAYZU_TOKEN });
const charge = await payzu.pix.create({
amount: 99.90,
clientReference: 'order-1234',
callbackUrl: 'https://seusite.com.br/webhooks/payzu',
});
console.log(charge.qrCodeText);A facade PayZu exige payzu-pix 1.0.0 ou superior.
import os
import payzu_pix
config = payzu_pix.Configuration(
host='https://api.payzu.processamento.com/v1',
access_token=os.environ['PAYZU_TOKEN'],
)
with payzu_pix.ApiClient(config) as client:
api = payzu_pix.PixOperationsApi(client)
charge = api.post_pix(post_pix_request={
'amount': 99.90,
'clientReference': 'order-1234',
'callbackUrl': 'https://seusite.com.br/webhooks/payzu',
})
print(charge.qr_code_text)Disponível a partir da versão 1.0.0.
import (
"context"
"os"
payzupix "github.com/PayZuPlus/payzu-sdks/go"
)
cfg := payzupix.NewConfiguration()
cfg.Servers = payzupix.ServerConfigurations{{URL: "https://api.payzu.processamento.com/v1"}}
client := payzupix.NewAPIClient(cfg)
ctx := context.WithValue(context.Background(), payzupix.ContextAccessToken, os.Getenv("PAYZU_TOKEN"))
req := payzupix.PostPixRequest{
Amount: 99.90,
ClientReference: payzupix.PtrString("order-1234"),
CallbackUrl: payzupix.PtrString("https://seusite.com.br/webhooks/payzu"),
}
charge, _, err := client.PixOperationsAPI.PostPix(ctx).PostPixRequest(req).Execute()Em breve. Depende da tag go/v1.0.0, criada no release.
Como funcionam
Workflow Generate SDKs (generate.yml) sincroniza diariamente do openapi.json da doc, regera os SDKs via openapi-generator-cli e abre PR.
Bug, dúvida ou sugestão
| Onde reportar | Quando |
|---|---|
| github.com/PayZuPlus/payzu-sdks/issues | Bug no SDK (não compila, falta método, tipo errado) |
| suporte.payzu.com.br | Bug na API ou conta |
| docs.payzu.com.br | Dúvida de uso |
Glossário
Termos, siglas, status e campos que aparecem na PayZu Processamento. Se você ficou travado em uma sigla do Bacen ou um campo da API, é aqui. Tudo em PT com o nome original quando relevante.
Postman
Collection oficial PayZu Pix com 29 endpoints prontos pra testar no Postman. Importa com um clique, Bearer token pré-configurado e mock server para desenvolvimento sem precisar de credenciais.