PayZuPayZu Docs

SDK

无需手动构建 fetch 即可与 PayZu Pix API 集成的官方 SDK。覆盖全部 29 个 endpoint、Bearer Auth 以及完整的 schema 类型定义。

安装

npm install payzu-pix
pip install payzu-pix
go get github.com/PayZuPlus/payzu-sdks/go
composer 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/issuesSDK 存在 bug(无法编译、缺少方法、类型错误)
suporte.payzu.com.brAPI 或账号问题
docs.payzu.com.br使用方面的疑问

On this page