Documentação PIX

Documentação: Gerar PIX

Saiba como utilizar o script para gerar PIX em sua aplicação.

Logo

Introdução

Este script permite a geração de um QR Code PIX utilizando um endpoint específico. É ideal para aplicações que precisam de integração com pagamentos via PIX.

Exemplo de Código

<?php $apiUrl = 'https://bazeus.com.br/v3/pix/qrcode'; $postData = [ 'client_id' => 'seu_client_id', 'client_secret' => 'seu_client_secret', 'nome' => 'Nome do Cliente', 'cpf' => 'CPF do Cliente', 'valor' => 100.00, 'descricao' => 'Descrição do pagamento', 'urlnoty' => 'https://seuservidor.com/callback' ]; $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $apiUrl); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($postData)); curl_setopt($ch, CURLOPT_HTTPHEADER, [ 'Content-Type: application/x-www-form-urlencoded', ]); $response = curl_exec($ch); if (curl_errno($ch)) { echo 'Erro cURL: ' . curl_error($ch); } else { echo 'Resposta do servidor: ' . $response; } curl_close($ch); ?>

Parâmetros

Parâmetro Descrição Exemplo
client_id Identificação do cliente "seu_client_id"
client_secret Chave secreta do cliente "seu_client_secret"
nome Nome do pagador "João da Silva"
cpf CPF do pagador "12345678901"
valor Valor da transação 100.00
descricao Descrição da transação "Pagamento de serviços"
urlnoty URL para receber notificações de callback "https://seuservidor.com/callback"

Respostas da API

Exemplo de Resposta 200:
{
"transactionId": "4392d1d7e408d3cec04fm1zf3gv7vkq1",
"external_id": "",
"status": "PENDING",
"amount": 15,
"calendar": {
"expiration": 3000,
"dueDate": "2024-10-07 04:41:05"
},
"debtor": {
"name": "Henrique Silva",
"document": "12924586666"
},
"qrcode": "00020126850014br.gov.bcb.pix2563pix.voluti.com.br/qr/v3/at/6ed39bf2-bdc2-42b8-a95b-13d2212146b25204000053039865802BR5925bazeus PAYMENTS SOLUTIONS LTD6008SALVADOR62070503***63048D9B"
}
Exemplo de Resposta 401:
{
"statusCode": 401,
"message": "Erro de autorização"
}

Documentação: Transferência PIX

Saiba como utilizar o script para realizar transferências via PIX em sua aplicação.

Introdução

Este script permite a realização de uma transferência PIX entre contas utilizando um endpoint específico. Ideal para sistemas que necessitam de integração com a API PIX para realizar pagamentos e transferências.

Exemplo de Código

<?php $apiUrl = 'https://bazeus.com.br/v3/pix/payment'; $postData = [ 'client_id' => 'SEU CLIENT ID', 'client_secret' => 'SEU CLIENT SECRET', 'nome' => 'Nome do cliente', 'cpf' => 'Cpf do cliente', 'valor' => 1.00, 'chave_pix' => 'Chave pix Cliente', 'urlnoty' => 'https://seuservidor.com/callback' ]; $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $apiUrl); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($postData)); curl_setopt($ch, CURLOPT_HTTPHEADER, [ 'Content-Type: application/x-www-form-urlencoded', ]); $response = curl_exec($ch); if (curl_errno($ch)) { echo 'Erro cURL: ' . curl_error($ch); } else { echo 'Resposta do servidor: ' . $response; } curl_close($ch); ?>

Parâmetros

Parâmetro Descrição Exemplo
client_id Identificação do cliente "seu_client_id"
client_secret Chave secreta do cliente "seu_client_secret"
nome Nome do pagador. "cris"
cpf CPF do pagador. "11970142332"
valor Valor da transferência. 1.00
chave_pix Chave PIX do destinatário. "chave@pix.com"
urlnoty URL para receber notificações de callback. "https://seuservidor.com/callback"

Respostas da API

Exemplo de Resposta 200:
[{"statusCode":200,"message":"Saque PIX processado com sucesso"}]
Exemplo de Resposta 400:
{"statusCode":400,"message":"Saldo insuficiente para cobrir valor e taxas."}

WEBHOOK-Evento de Pagamento

Será lhe enviado um alerta por meio de um Webhook assim que o pagamento for confirmado pelo nosso sistema, segue abaixo o modelo JSON do payload enviado:
{ "requestBody": { "transactionType": "RECEIVEPIX", "transactionId": "c327ce8bee2a18565ec2m1zdu6px2keu", "external_id": "55aefd02e54e785fbb5a80faa19f8802", "amount": 15.00, "paymentType": "PIX", "status": "PAID", "dateApproval": "2024-10-07 16:07:10", "creditParty": { "name": "Henrique silva", "email": "billiPagamentos@gmail.com", "taxId": "999999999" }, "debitParty": { "bank": "bazeus SOLUCOES DE PAGAMENTOS LTDA", "taxId": "46872831000154" } } }

WEBHOOK-Evento de Transferência

Será lhe enviado um alerta por meio de um Webhook assim que o pagamento for confirmado pelo nosso sistema, segue abaixo o modelo JSON do payload enviado:
{ "transactionType": "PAYMENT", "transactionId": "798176179", "external_id": "ebceb2b835598ccad73ce42eb5etrh2m5", "amount": 1, "dateApproval": "2024-12-19 17:10:54", "statusCode": { "statusId": 1, "description": "Pagamento aprovado" } }