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-pixgo get github.com/PayZuPlus/payzu-sdks/gocomposer require payzu/pixUso
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',
]);Como funcionam
Workflow Generate SDKs (generate.yml) sincroniza diariamente do openapi.json da doc, regera os 4 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.