SDK
无需手动构建 fetch 即可与 PayZu Pix API 集成的官方 SDK。覆盖全部 29 个 endpoint、Bearer Auth 以及完整的 schema 类型定义。
安装
npm install payzu-pixpip install payzu-pixgo get github.com/PayZuPlus/payzu-sdks/gocomposer require payzu/pix使用方式
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',
]);工作原理
Generate SDKs workflow(generate.yml)每日从文档的 openapi.json 同步,通过 openapi-generator-cli 重新生成 4 个 SDK 并提交 PR。
Bug、疑问或建议
| 反馈渠道 | 适用场景 |
|---|---|
| github.com/PayZuPlus/payzu-sdks/issues | SDK 存在 bug(无法编译、缺少方法、类型错误) |
| suporte.payzu.com.br | API 或账号问题 |
| docs.payzu.com.br | 使用方面的疑问 |
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.