PagamentosCriar Cobrança PIX

Criar Cobrança PIX

Transacione via PIX. Envia os dados do pagador e o valor. A API retorna o PIX Copia e Cola pronto pro seu cliente pagar no app do banco.


Endpoint

POST https://isolutionpay.com/api/pix

Campos

Obrigatórios

CampoTipoDescrição
amountinteiroValor em centavos. Ex: 4990 = R$ 49,90
nomestringNome completo do pagador
cpfstringCPF do pagador, com ou sem pontuação

Opcionais

CampoTipoDescrição
emailstringE-mail do pagador
phonestringTelefone do pagador (apenas dígitos)
descricaostringDescrição exibida na cobrança (máx. 120 caracteres)
product_idstringUUID do produto vinculado à venda

Exemplos

curl -X POST https://isolutionpay.com/api/pix \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer isolutionpay_sk_SUA_CHAVE_AQUI" \
  -d '{
    "amount": 9990,
    "nome": "João Silva",
    "cpf": "12345678900",
    "email": "joao@email.com"
  }'
const res = await fetch("https://isolutionpay.com/api/pix", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer isolutionpay_sk_SUA_CHAVE_AQUI"
  },
  body: JSON.stringify({
    amount: 9990,
    nome: "João Silva",
    cpf: "12345678900",
    email: "joao@email.com"
  })
});
 
const { txid, pixCopiaECola } = await res.json();
// Exiba pixCopiaECola pro cliente pagar
// Salve txid para verificar depois
import requests
 
res = requests.post(
    "https://isolutionpay.com/api/pix",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer isolutionpay_sk_SUA_CHAVE_AQUI"
    },
    json={"amount": 9990, "nome": "João Silva", "cpf": "12345678900", "email": "joao@email.com"}
)
 
data = res.json()
txid = data["txid"]
pix = data["pixCopiaECola"]

Resposta

{
  "success": true,
  "id": "a1b2c3d4-...",
  "txid": "a1b2c3d4-...",
  "pixCopiaECola": "00020126580014br.gov.bcb.pix...",
  "qrCode": null,
  "amount": 9990,
  "status": "pending",
  "expiresAt": "2025-08-07T15:00:00.000Z"
}
CampoDescrição
txidID da transação. Salve para verificar o pagamento depois
pixCopiaEColaCódigo PIX Copia e Cola para exibir ao cliente
qrCodeURL ou base64 da imagem QR (pode ser null dependendo do adquirente)
amountValor em centavos confirmado pela API
statusSempre começa como pending
expiresAtData/hora de expiração do PIX

O PIX expira em 60 minutos.