Criar Cobrança PIX

Criar cobrança PIX

curl --request POST \
  --url https://api.liquerapay.com/transparents/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "method": "PIX",
  "amount": 5000,
  "description": "Pedido",
  "customerId": "cust_018f3a2b7c4d7c40a1b2",
  "expiresIn": 1800
}
'

import requests

url = "https://api.liquerapay.com/transparents/create"

payload = {
    "method": "PIX",
    "amount": 5000,
    "description": "Pedido",
    "customerId": "cust_018f3a2b7c4d7c40a1b2",
    "expiresIn": 1800
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    method: 'PIX',
    amount: 5000,
    description: 'Pedido',
    customerId: 'cust_018f3a2b7c4d7c40a1b2',
    expiresIn: 1800
  })
};

fetch('https://api.liquerapay.com/transparents/create', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.liquerapay.com/transparents/create",
  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([
    'method' => 'PIX',
    'amount' => 5000,
    'description' => 'Pedido',
    'customerId' => 'cust_018f3a2b7c4d7c40a1b2',
    'expiresIn' => 1800
  ]),
  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://api.liquerapay.com/transparents/create"

	payload := strings.NewReader("{\n  \"method\": \"PIX\",\n  \"amount\": 5000,\n  \"description\": \"Pedido\",\n  \"customerId\": \"cust_018f3a2b7c4d7c40a1b2\",\n  \"expiresIn\": 1800\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))

}

HttpResponse<String> response = Unirest.post("https://api.liquerapay.com/transparents/create")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"method\": \"PIX\",\n  \"amount\": 5000,\n  \"description\": \"Pedido\",\n  \"customerId\": \"cust_018f3a2b7c4d7c40a1b2\",\n  \"expiresIn\": 1800\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.liquerapay.com/transparents/create")

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  \"method\": \"PIX\",\n  \"amount\": 5000,\n  \"description\": \"Pedido\",\n  \"customerId\": \"cust_018f3a2b7c4d7c40a1b2\",\n  \"expiresIn\": 1800\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "id": "chg_018f8e2d9a5f7b10c3d4",
    "amount": 5000,
    "status": "PAID",
    "txid": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f",
    "brCode": "00020126580014BR.GOV.BCB.PIX0136abc...6304ABCD",
    "imageBase64": "data:image/png;base64,iVBORw0KGgoAAAA...",
    "createdAt": "2026-04-19T18:32:11.420Z",
    "expiresAt": "2026-04-19T19:02:11.420Z",
    "customer": {
      "id": "cust_018f3a2b7c4d7c40a1b2",
      "name": "João Silva",
      "taxId": "12345678900",
      "email": "joao@exemplo.com",
      "phone": "+5511999999999"
    }
  },
  "error": null,
  "success": true
}

POST

transparents

create

Criar cobrança PIX

curl --request POST \
  --url https://api.liquerapay.com/transparents/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "method": "PIX",
  "amount": 5000,
  "description": "Pedido",
  "customerId": "cust_018f3a2b7c4d7c40a1b2",
  "expiresIn": 1800
}
'

import requests

url = "https://api.liquerapay.com/transparents/create"

payload = {
    "method": "PIX",
    "amount": 5000,
    "description": "Pedido",
    "customerId": "cust_018f3a2b7c4d7c40a1b2",
    "expiresIn": 1800
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    method: 'PIX',
    amount: 5000,
    description: 'Pedido',
    customerId: 'cust_018f3a2b7c4d7c40a1b2',
    expiresIn: 1800
  })
};

fetch('https://api.liquerapay.com/transparents/create', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.liquerapay.com/transparents/create",
  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([
    'method' => 'PIX',
    'amount' => 5000,
    'description' => 'Pedido',
    'customerId' => 'cust_018f3a2b7c4d7c40a1b2',
    'expiresIn' => 1800
  ]),
  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://api.liquerapay.com/transparents/create"

	payload := strings.NewReader("{\n  \"method\": \"PIX\",\n  \"amount\": 5000,\n  \"description\": \"Pedido\",\n  \"customerId\": \"cust_018f3a2b7c4d7c40a1b2\",\n  \"expiresIn\": 1800\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))

}

HttpResponse<String> response = Unirest.post("https://api.liquerapay.com/transparents/create")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"method\": \"PIX\",\n  \"amount\": 5000,\n  \"description\": \"Pedido\",\n  \"customerId\": \"cust_018f3a2b7c4d7c40a1b2\",\n  \"expiresIn\": 1800\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.liquerapay.com/transparents/create")

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  \"method\": \"PIX\",\n  \"amount\": 5000,\n  \"description\": \"Pedido\",\n  \"customerId\": \"cust_018f3a2b7c4d7c40a1b2\",\n  \"expiresIn\": 1800\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "id": "chg_018f8e2d9a5f7b10c3d4",
    "amount": 5000,
    "status": "PAID",
    "txid": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f",
    "brCode": "00020126580014BR.GOV.BCB.PIX0136abc...6304ABCD",
    "imageBase64": "data:image/png;base64,iVBORw0KGgoAAAA...",
    "createdAt": "2026-04-19T18:32:11.420Z",
    "expiresAt": "2026-04-19T19:02:11.420Z",
    "customer": {
      "id": "cust_018f3a2b7c4d7c40a1b2",
      "name": "João Silva",
      "taxId": "12345678900",
      "email": "joao@exemplo.com",
      "phone": "+5511999999999"
    }
  },
  "error": null,
  "success": true
}

Cria uma cobrança PIX e retorna um QR Code pronto para apresentar ao cliente.

Obrigatório

method (fixo em "PIX") e amount (em centavos, mínimo 100). Os demais campos são opcionais.

Exemplo:

{
  "method": "PIX",
  "amount": 5000,
  "description": "Pedido #1234",
  "customerId": "cust_018f3a2b7c4d7c40a1b2",
  "expiresIn": 1800
}

Como apresentar o QR Code

A resposta traz dois formatos — escolha o melhor para seu canal:

brCode (texto)

String copia-e-cola. Ideal para web/mobile com botão “Copiar código”.

imageBase64 (imagem)

PNG em base64 (data:image/png;base64,...). Renderize com <img src={...}>.

<!-- Renderizando direto no HTML -->
<img src="data:image/png;base64,iVBORw0KGgoAAAA..." alt="QR Code PIX" />

Validações importantes

Sua conta precisa estar apta a cobrar

O merchant precisa ter cobranças habilitadas e uma chave PIX ativa cadastrada. Sem isso, a criação retorna 400 BAD_REQUEST.

amount respeita os limites do merchant

Sua conta tem minTicket e maxTicket definidos, além do limite fixo de 100 a 100.000.000 centavos. Valores fora do intervalo retornam 400 BAD_REQUEST.

customerId precisa existir e pertencer ao seu merchant

Se o customer não existir (ou pertencer a outro merchant), você recebe 404 NOT_FOUND.

expiresIn entre 60 e 2.592.000 segundos

Mínimo 1 minuto, máximo 30 dias. Padrão: 86400 segundos (24h). Atenção: o campo é em segundos, não minutos.

description tem no máximo 140 caracteres

Texto exibido para o cliente no app de pagamento. Não envie dados sensíveis (PII, senhas, tokens).

Authorizations

Authorization

string

header

required

Autentique suas requisições enviando o token no header Authorization: Bearer <token>.

O token pode ser:

Uma API key com prefixo liq_, gerada em Dashboard Liquerapay → Configurações → API Keys.
Um JWT retornado pelo login do dashboard (uso interno).

Não há distinção de ambiente — toda chave vale para o único ambiente disponível (produção).

Body

application/json

method

enum<string>

required

Método de pagamento — hoje só "PIX" é suportado.

Available options:

PIX

Example:

"PIX"

amount

integer

required

Valor da cobrança em centavos, sujeito ao limite do merchant.

Required range: 100 <= x <= 100000000

Example:

5000

description

string

Texto que aparece para o cliente no momento do pagamento.

Maximum string length: 140

Example:

"Pedido"

customerId

string

Opcional. ID de um cliente já cadastrado para anexar à cobrança.

Maximum string length: 50

Example:

"cust_018f3a2b7c4d7c40a1b2"

expiresIn

integer

default:86400

Tempo de validade do QR Code em segundos (60 a 2.592.000 = 30 dias). Padrão 86400 = 24h.

Required range: 60 <= x <= 2592000

Example:

1800

Response

Cobrança criada — apresente brCode ou imageBase64 ao cliente.

data

object

required

Show child attributes

error

null

required

Example:

null

success

enum<boolean>

required

Available options:

true

Example:

true

⌘I

Clientes

Checkout Transparente

Saques

Webhooks

Obrigatório

Como apresentar o QR Code

brCode (texto)

imageBase64 (imagem)

Validações importantes

Authorizations

Body

Response

Obrigatório

​Como apresentar o QR Code

brCode (texto)

imageBase64 (imagem)

​Validações importantes

Authorizations

Body

Response

Como apresentar o QR Code

Validações importantes