SDKs
Official SDKs to integrate with the PayZu Pix API without having to assemble fetch calls by hand. They cover all 29 endpoints, Bearer Auth and full schema typing.
Installation
npm install payzu-pixpip install payzu-pixgo get github.com/PayZuPlus/payzu-sdks/gocomposer require payzu/pixUsage
import { Configuration, PixOperationsApi } from 'payzu-pix';
const config = new Configuration({
accessToken: process.env.PAYZU_TOKEN,
basePath: 'https://api.payzu.processamento.com/v1',
});
const pix = new PixOperationsApi(config);
const charge = await pix.postPix({
postPixRequest: {
amount: 99.90,
clientReference: 'order-1234',
callbackUrl: 'https://seusite.com.br/webhooks/payzu',
},
});
console.log(charge.qrCodeText);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)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()<?php
use PayZuPix\Configuration;
use PayZuPix\Api\PixOperationsApi;
use GuzzleHttp\Client;
$config = Configuration::getDefaultConfiguration()
->setHost('https://api.payzu.processamento.com/v1')
->setAccessToken(getenv('PAYZU_TOKEN'));
$api = new PixOperationsApi(new Client(), $config);
$charge = $api->postPix([
'amount' => 99.90,
'clientReference' => 'order-1234',
'callbackUrl' => 'https://seusite.com.br/webhooks/payzu',
]);How they work
The Generate SDKs workflow (generate.yml) syncs daily from the docs' openapi.json, regenerates all 4 SDKs via openapi-generator-cli and opens a PR.
Bug, question or suggestion
| Where to report | When |
|---|---|
| github.com/PayZuPlus/payzu-sdks/issues | SDK bug (won't compile, missing method, wrong type) |
| suporte.payzu.com.br | API or account bug |
| docs.payzu.com.br | Usage question |
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.