Gerar transação PIX

curl -X POST "https://api.pix.basspago.com.br/cob" \
  --cert ./client.crt \
  --key ./client.key \
  --pass "SUA_SENHA_DO_CERTIFICADO" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "calendario": {
      "expiracao": 3600
    },
    "devedor": {
      "cpf": "11144477735",
      "nome": "Maria Oliveira"
    },
    "valor": {
      "original": "49.90"
    },
    "chave": "e3b0c442-98fc-4c1a-b2d6-9a7f5e10c3d4",
    "solicitacaoPagador": "Pagamento do pedido #90210"
  }'

<?php

$ch = curl_init('https://api.pix.basspago.com.br/cob');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_SSLCERT => './client.crt',
    CURLOPT_SSLKEY => './client.key',
    CURLOPT_KEYPASSWD => 'SUA_SENHA_DO_CERTIFICADO',
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'Authorization: Bearer {access_token}',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'calendario' => ['expiracao' => 3600],
        'devedor' => ['cpf' => '11144477735', 'nome' => 'Maria Oliveira'],
        'valor' => ['original' => '49.90'],
        'chave' => 'e3b0c442-98fc-4c1a-b2d6-9a7f5e10c3d4',
        'solicitacaoPagador' => 'Pagamento do pedido #90210',
    ]),
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

import fs from "node:fs";
import https from "node:https";
import axios from "axios";

const agent = new https.Agent({
  cert: fs.readFileSync("./client.crt"),
  key: fs.readFileSync("./client.key"),
  passphrase: "SUA_SENHA_DO_CERTIFICADO",
});

const { data } = await axios.post(
  "https://api.pix.basspago.com.br/cob",
  {
    calendario: { expiracao: 3600 },
    devedor: { cpf: "11144477735", nome: "Maria Oliveira" },
    valor: { original: "49.90" },
    chave: "e3b0c442-98fc-4c1a-b2d6-9a7f5e10c3d4",
    solicitacaoPagador: "Pagamento do pedido #90210",
  },
  {
    httpsAgent: agent,
    headers: { Authorization: "Bearer {access_token}" },
  }
);

console.log(data);

{
  "calendario": {
    "criacao": "2026-07-21T13:05:12.000Z",
    "expiracao": 3600
  },
  "txid": "a1b2c3d4e5f60718293a4b5c6d7e8f90",
  "revisao": 0,
  "loc": {
    "id": 4821,
    "location": "pix.basspago.com/qr/v2/9f8e7d6c5b4a",
    "tipoCob": "cob"
  },
  "location": "pix.basspago.com/qr/v2/9f8e7d6c5b4a",
  "status": "ATIVA",
  "devedor": {
    "cpf": "11144477735",
    "nome": "Maria Oliveira"
  },
  "valor": {
    "original": "49.90"
  },
  "chave": "e3b0c442-98fc-4c1a-b2d6-9a7f5e10c3d4",
  "solicitacaoPagador": "Pagamento do pedido #90210",
  "infoAdicionais": [
    {
      "nome": "Pedido",
      "valor": "90210"
    }
  ],
  "pixCopiaECola": "00020126580014br.gov.bcb.pix..."
}

POST

cob

curl -X POST "https://api.pix.basspago.com.br/cob" \
  --cert ./client.crt \
  --key ./client.key \
  --pass "SUA_SENHA_DO_CERTIFICADO" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "calendario": {
      "expiracao": 3600
    },
    "devedor": {
      "cpf": "11144477735",
      "nome": "Maria Oliveira"
    },
    "valor": {
      "original": "49.90"
    },
    "chave": "e3b0c442-98fc-4c1a-b2d6-9a7f5e10c3d4",
    "solicitacaoPagador": "Pagamento do pedido #90210"
  }'

<?php

$ch = curl_init('https://api.pix.basspago.com.br/cob');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_SSLCERT => './client.crt',
    CURLOPT_SSLKEY => './client.key',
    CURLOPT_KEYPASSWD => 'SUA_SENHA_DO_CERTIFICADO',
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'Authorization: Bearer {access_token}',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'calendario' => ['expiracao' => 3600],
        'devedor' => ['cpf' => '11144477735', 'nome' => 'Maria Oliveira'],
        'valor' => ['original' => '49.90'],
        'chave' => 'e3b0c442-98fc-4c1a-b2d6-9a7f5e10c3d4',
        'solicitacaoPagador' => 'Pagamento do pedido #90210',
    ]),
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

import fs from "node:fs";
import https from "node:https";
import axios from "axios";

const agent = new https.Agent({
  cert: fs.readFileSync("./client.crt"),
  key: fs.readFileSync("./client.key"),
  passphrase: "SUA_SENHA_DO_CERTIFICADO",
});

const { data } = await axios.post(
  "https://api.pix.basspago.com.br/cob",
  {
    calendario: { expiracao: 3600 },
    devedor: { cpf: "11144477735", nome: "Maria Oliveira" },
    valor: { original: "49.90" },
    chave: "e3b0c442-98fc-4c1a-b2d6-9a7f5e10c3d4",
    solicitacaoPagador: "Pagamento do pedido #90210",
  },
  {
    httpsAgent: agent,
    headers: { Authorization: "Bearer {access_token}" },
  }
);

console.log(data);

{
  "calendario": {
    "criacao": "2026-07-21T13:05:12.000Z",
    "expiracao": 3600
  },
  "txid": "a1b2c3d4e5f60718293a4b5c6d7e8f90",
  "revisao": 0,
  "loc": {
    "id": 4821,
    "location": "pix.basspago.com/qr/v2/9f8e7d6c5b4a",
    "tipoCob": "cob"
  },
  "location": "pix.basspago.com/qr/v2/9f8e7d6c5b4a",
  "status": "ATIVA",
  "devedor": {
    "cpf": "11144477735",
    "nome": "Maria Oliveira"
  },
  "valor": {
    "original": "49.90"
  },
  "chave": "e3b0c442-98fc-4c1a-b2d6-9a7f5e10c3d4",
  "solicitacaoPagador": "Pagamento do pedido #90210",
  "infoAdicionais": [
    {
      "nome": "Pedido",
      "valor": "90210"
    }
  ],
  "pixCopiaECola": "00020126580014br.gov.bcb.pix..."
}

Essa rota utiliza os certificados e o Bearer Token de Cash In.

Certificados

Esta rota usa autenticação mútua (mTLS). Envie o certificado de Cash In, a chave e a senha na requisição:

file

required

Certificado de Cash In do cliente (client.crt).

file

required

Chave privada do cliente (client.key).

string

required

Senha para descriptografar a chave .key, enviada por e-mail junto com os certificados.

Headers

string

required

Formato do corpo da requisição. Use application/json.

string

required

Bearer Token de Cash In. Formato: Bearer {access_token}.

Body

integer

required

Tempo em segundos para a cobrança expirar.

string

CPF do cliente.

string

Nome do cliente.

string

required

Valor da cobrança em reais. Exemplo: "50.00".

string

required

Chave Pix cadastrada na conta. É retornada ao gerar as credenciais de Cash In.

string

Descrição do pagamento. Fica visível para o cliente.

array

Informações internas opcionais, no formato { "nome": "...", "valor": "..." }.

Resposta

string

Identificador único da cobrança.

string

Status da cobrança. Ao criar, retorna ATIVA.

object

Datas da cobrança.

Show calendario

string

Data e hora de criação (ISO 8601).

integer

Tempo de expiração, em segundos.

object

Dados da location do QR Code (id, location, tipoCob).

string

URL da location usada para renderizar o QR Code.

object

Valor da cobrança (original).

string

Chave Pix que recebe o pagamento.

string

Código Pix copia e cola que o cliente usa para pagar.

curl -X POST "https://api.pix.basspago.com.br/cob" \
  --cert ./client.crt \
  --key ./client.key \
  --pass "SUA_SENHA_DO_CERTIFICADO" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "calendario": {
      "expiracao": 3600
    },
    "devedor": {
      "cpf": "11144477735",
      "nome": "Maria Oliveira"
    },
    "valor": {
      "original": "49.90"
    },
    "chave": "e3b0c442-98fc-4c1a-b2d6-9a7f5e10c3d4",
    "solicitacaoPagador": "Pagamento do pedido #90210"
  }'

<?php

$ch = curl_init('https://api.pix.basspago.com.br/cob');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_SSLCERT => './client.crt',
    CURLOPT_SSLKEY => './client.key',
    CURLOPT_KEYPASSWD => 'SUA_SENHA_DO_CERTIFICADO',
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'Authorization: Bearer {access_token}',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'calendario' => ['expiracao' => 3600],
        'devedor' => ['cpf' => '11144477735', 'nome' => 'Maria Oliveira'],
        'valor' => ['original' => '49.90'],
        'chave' => 'e3b0c442-98fc-4c1a-b2d6-9a7f5e10c3d4',
        'solicitacaoPagador' => 'Pagamento do pedido #90210',
    ]),
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

import fs from "node:fs";
import https from "node:https";
import axios from "axios";

const agent = new https.Agent({
  cert: fs.readFileSync("./client.crt"),
  key: fs.readFileSync("./client.key"),
  passphrase: "SUA_SENHA_DO_CERTIFICADO",
});

const { data } = await axios.post(
  "https://api.pix.basspago.com.br/cob",
  {
    calendario: { expiracao: 3600 },
    devedor: { cpf: "11144477735", nome: "Maria Oliveira" },
    valor: { original: "49.90" },
    chave: "e3b0c442-98fc-4c1a-b2d6-9a7f5e10c3d4",
    solicitacaoPagador: "Pagamento do pedido #90210",
  },
  {
    httpsAgent: agent,
    headers: { Authorization: "Bearer {access_token}" },
  }
);

console.log(data);

{
  "calendario": {
    "criacao": "2026-07-21T13:05:12.000Z",
    "expiracao": 3600
  },
  "txid": "a1b2c3d4e5f60718293a4b5c6d7e8f90",
  "revisao": 0,
  "loc": {
    "id": 4821,
    "location": "pix.basspago.com/qr/v2/9f8e7d6c5b4a",
    "tipoCob": "cob"
  },
  "location": "pix.basspago.com/qr/v2/9f8e7d6c5b4a",
  "status": "ATIVA",
  "devedor": {
    "cpf": "11144477735",
    "nome": "Maria Oliveira"
  },
  "valor": {
    "original": "49.90"
  },
  "chave": "e3b0c442-98fc-4c1a-b2d6-9a7f5e10c3d4",
  "solicitacaoPagador": "Pagamento do pedido #90210",
  "infoAdicionais": [
    {
      "nome": "Pedido",
      "valor": "90210"
    }
  ],
  "pixCopiaECola": "00020126580014br.gov.bcb.pix..."
}

Guia de implementação

Transações

Transferências

Contestações

Certificados

Headers

Body

Resposta

​Certificados

​Headers

​Body

​Resposta

Certificados

Headers

Body

Resposta