curl --request POST \
--url https://app.pixzypay.com/api/transactions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"amount": 1000,
"client_name": "João Silva",
"client_email": "joao@email.com",
"client_doc": "123.456.789-00",
"client_phone": "(11) 99999-9999",
"webhook_url": "https://api.loja.com/pix",
"metadata": {
"pedido_id": "ABC-123"
},
"items": [
{
"name": "Curso de Marketing",
"price": 700,
"quantity": 1
},
{
"name": "Ebook Bônus",
"price": 300,
"quantity": 1
}
]
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
amount: 1000,
client_name: 'João Silva',
client_email: 'joao@email.com',
client_doc: '123.456.789-00',
client_phone: '(11) 99999-9999',
webhook_url: 'https://api.loja.com/pix',
metadata: {pedido_id: 'ABC-123'},
items: [
{name: 'Curso de Marketing', price: 700, quantity: 1},
{name: 'Ebook Bônus', price: 300, quantity: 1}
]
})
};
fetch('https://app.pixzypay.com/api/transactions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.pixzypay.com/api/transactions"
payload = {
"amount": 1000,
"client_name": "João Silva",
"client_email": "joao@email.com",
"client_doc": "123.456.789-00",
"client_phone": "(11) 99999-9999",
"webhook_url": "https://api.loja.com/pix",
"metadata": { "pedido_id": "ABC-123" },
"items": [
{
"name": "Curso de Marketing",
"price": 700,
"quantity": 1
},
{
"name": "Ebook Bônus",
"price": 300,
"quantity": 1
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.pixzypay.com/api/transactions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'amount' => 1000,
'client_name' => 'João Silva',
'client_email' => 'joao@email.com',
'client_doc' => '123.456.789-00',
'client_phone' => '(11) 99999-9999',
'webhook_url' => 'https://api.loja.com/pix',
'metadata' => [
'pedido_id' => 'ABC-123'
],
'items' => [
[
'name' => 'Curso de Marketing',
'price' => 700,
'quantity' => 1
],
[
'name' => 'Ebook Bônus',
'price' => 300,
'quantity' => 1
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.pixzypay.com/api/transactions"
payload := strings.NewReader("{\n \"amount\": 1000,\n \"client_name\": \"João Silva\",\n \"client_email\": \"joao@email.com\",\n \"client_doc\": \"123.456.789-00\",\n \"client_phone\": \"(11) 99999-9999\",\n \"webhook_url\": \"https://api.loja.com/pix\",\n \"metadata\": {\n \"pedido_id\": \"ABC-123\"\n },\n \"items\": [\n {\n \"name\": \"Curso de Marketing\",\n \"price\": 700,\n \"quantity\": 1\n },\n {\n \"name\": \"Ebook Bônus\",\n \"price\": 300,\n \"quantity\": 1\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}require 'uri'
require 'net/http'
url = URI("https://app.pixzypay.com/api/transactions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"amount\": 1000,\n \"client_name\": \"João Silva\",\n \"client_email\": \"joao@email.com\",\n \"client_doc\": \"123.456.789-00\",\n \"client_phone\": \"(11) 99999-9999\",\n \"webhook_url\": \"https://api.loja.com/pix\",\n \"metadata\": {\n \"pedido_id\": \"ABC-123\"\n },\n \"items\": [\n {\n \"name\": \"Curso de Marketing\",\n \"price\": 700,\n \"quantity\": 1\n },\n {\n \"name\": \"Ebook Bônus\",\n \"price\": 300,\n \"quantity\": 1\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"data": {
"transaction_id": "019c7547-0433-7363-b8d8-704680370307",
"br_code": "00020126580014BR.GOV.BCB.PIX...",
"amount": 1000,
"status": "pending",
"metadata": {
"pedido_id": "ABC-123"
}
}
}{
"error": "Unauthenticated"
}{
"error": "Account not active"
}{
"errors": "O campo amount é obrigatório."
}{
"error": "Too Many Requests"
}{
"error": "Service unavailable"
}Criar Transação
Cria uma nova cobrança PIX dinâmica com processamento instantâneo.
curl --request POST \
--url https://app.pixzypay.com/api/transactions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"amount": 1000,
"client_name": "João Silva",
"client_email": "joao@email.com",
"client_doc": "123.456.789-00",
"client_phone": "(11) 99999-9999",
"webhook_url": "https://api.loja.com/pix",
"metadata": {
"pedido_id": "ABC-123"
},
"items": [
{
"name": "Curso de Marketing",
"price": 700,
"quantity": 1
},
{
"name": "Ebook Bônus",
"price": 300,
"quantity": 1
}
]
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
amount: 1000,
client_name: 'João Silva',
client_email: 'joao@email.com',
client_doc: '123.456.789-00',
client_phone: '(11) 99999-9999',
webhook_url: 'https://api.loja.com/pix',
metadata: {pedido_id: 'ABC-123'},
items: [
{name: 'Curso de Marketing', price: 700, quantity: 1},
{name: 'Ebook Bônus', price: 300, quantity: 1}
]
})
};
fetch('https://app.pixzypay.com/api/transactions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.pixzypay.com/api/transactions"
payload = {
"amount": 1000,
"client_name": "João Silva",
"client_email": "joao@email.com",
"client_doc": "123.456.789-00",
"client_phone": "(11) 99999-9999",
"webhook_url": "https://api.loja.com/pix",
"metadata": { "pedido_id": "ABC-123" },
"items": [
{
"name": "Curso de Marketing",
"price": 700,
"quantity": 1
},
{
"name": "Ebook Bônus",
"price": 300,
"quantity": 1
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.pixzypay.com/api/transactions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'amount' => 1000,
'client_name' => 'João Silva',
'client_email' => 'joao@email.com',
'client_doc' => '123.456.789-00',
'client_phone' => '(11) 99999-9999',
'webhook_url' => 'https://api.loja.com/pix',
'metadata' => [
'pedido_id' => 'ABC-123'
],
'items' => [
[
'name' => 'Curso de Marketing',
'price' => 700,
'quantity' => 1
],
[
'name' => 'Ebook Bônus',
'price' => 300,
'quantity' => 1
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.pixzypay.com/api/transactions"
payload := strings.NewReader("{\n \"amount\": 1000,\n \"client_name\": \"João Silva\",\n \"client_email\": \"joao@email.com\",\n \"client_doc\": \"123.456.789-00\",\n \"client_phone\": \"(11) 99999-9999\",\n \"webhook_url\": \"https://api.loja.com/pix\",\n \"metadata\": {\n \"pedido_id\": \"ABC-123\"\n },\n \"items\": [\n {\n \"name\": \"Curso de Marketing\",\n \"price\": 700,\n \"quantity\": 1\n },\n {\n \"name\": \"Ebook Bônus\",\n \"price\": 300,\n \"quantity\": 1\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}require 'uri'
require 'net/http'
url = URI("https://app.pixzypay.com/api/transactions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"amount\": 1000,\n \"client_name\": \"João Silva\",\n \"client_email\": \"joao@email.com\",\n \"client_doc\": \"123.456.789-00\",\n \"client_phone\": \"(11) 99999-9999\",\n \"webhook_url\": \"https://api.loja.com/pix\",\n \"metadata\": {\n \"pedido_id\": \"ABC-123\"\n },\n \"items\": [\n {\n \"name\": \"Curso de Marketing\",\n \"price\": 700,\n \"quantity\": 1\n },\n {\n \"name\": \"Ebook Bônus\",\n \"price\": 300,\n \"quantity\": 1\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"data": {
"transaction_id": "019c7547-0433-7363-b8d8-704680370307",
"br_code": "00020126580014BR.GOV.BCB.PIX...",
"amount": 1000,
"status": "pending",
"metadata": {
"pedido_id": "ABC-123"
}
}
}{
"error": "Unauthenticated"
}{
"error": "Account not active"
}{
"errors": "O campo amount é obrigatório."
}{
"error": "Too Many Requests"
}{
"error": "Service unavailable"
}Authorizations
Bearer Token gerado em Configurações > Tokens de API.
Body
Valor em centavos (mínimo: 500 = R$ 5,00).
x >= 5001000
Nome completo do pagador.
"João Silva"
E-mail válido do pagador.
"joao@email.com"
CPF ou CNPJ (apenas números ou formatado).
"123.456.789-00"
Telefone do pagador.
"(11) 99999-9999"
URL para receber notificações de status.
IP do cliente. Se não enviado, é capturado automaticamente.
Objeto JSON com dados extras (máximo 20 chaves).
Objeto com parâmetros UTM de rastreamento.
Itens que compõem o pedido (máximo 50), para descrever o que está sendo vendido. Campo opcional e retrocompatível: requisições sem items continuam funcionando como antes. Os itens são puramente descritivos — não criam produtos na plataforma. O valor cobrado é sempre o amount da transação; a soma dos itens não altera a cobrança. Recomendamos que a soma de price × quantity seja igual ao amount.
50Show child attributes
Show child attributes

