curl -X GET "https://api.pix.basspago.com.br/cob/a1b2c3d4e5f60718293a4b5c6d7e8f90" \
--cert ./client.crt \
--key ./client.key \
--pass "SUA_SENHA_DO_CERTIFICADO" \
-H "Authorization: Bearer {access_token}"
<?php
$txid = 'a1b2c3d4e5f60718293a4b5c6d7e8f90';
$ch = curl_init("https://api.pix.basspago.com.br/cob/{$txid}");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_SSLCERT => './client.crt',
CURLOPT_SSLKEY => './client.key',
CURLOPT_KEYPASSWD => 'SUA_SENHA_DO_CERTIFICADO',
CURLOPT_HTTPHEADER => ['Authorization: Bearer {access_token}'],
]);
$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 txid = "a1b2c3d4e5f60718293a4b5c6d7e8f90";
const { data } = await axios.get(
`https://api.pix.basspago.com.br/cob/${txid}`,
{
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": "CONCLUIDA",
"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"
}
],
"pix": [
{
"endToEndId": "E12345678202607211307a1b2c3d4e5f",
"txid": "a1b2c3d4e5f60718293a4b5c6d7e8f90",
"valor": "49.90",
"horario": "2026-07-21T13:07:22.000Z",
"infoPagador": "Pagamento referente ao pedido #90210"
}
],
"pixCopiaECola": "00020126580014br.gov.bcb.pix..."
}
Transações
Consultar transação
Consulte os dados completos da sua transação PIX. Verifique informações do pagador, dados da transação e do pagamento.
GET
/
cob
/
{txid}
curl -X GET "https://api.pix.basspago.com.br/cob/a1b2c3d4e5f60718293a4b5c6d7e8f90" \
--cert ./client.crt \
--key ./client.key \
--pass "SUA_SENHA_DO_CERTIFICADO" \
-H "Authorization: Bearer {access_token}"
<?php
$txid = 'a1b2c3d4e5f60718293a4b5c6d7e8f90';
$ch = curl_init("https://api.pix.basspago.com.br/cob/{$txid}");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_SSLCERT => './client.crt',
CURLOPT_SSLKEY => './client.key',
CURLOPT_KEYPASSWD => 'SUA_SENHA_DO_CERTIFICADO',
CURLOPT_HTTPHEADER => ['Authorization: Bearer {access_token}'],
]);
$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 txid = "a1b2c3d4e5f60718293a4b5c6d7e8f90";
const { data } = await axios.get(
`https://api.pix.basspago.com.br/cob/${txid}`,
{
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": "CONCLUIDA",
"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"
}
],
"pix": [
{
"endToEndId": "E12345678202607211307a1b2c3d4e5f",
"txid": "a1b2c3d4e5f60718293a4b5c6d7e8f90",
"valor": "49.90",
"horario": "2026-07-21T13:07:22.000Z",
"infoPagador": "Pagamento referente ao pedido #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
Bearer Token de Cash In. Formato:
Bearer {access_token}.Path
string
required
Identificador único da cobrança, retornado ao gerar a transação.
Resposta
string
Identificador único da cobrança.
string
Status atual da cobrança. Exemplos:
ATIVA, CONCLUIDA, REMOVIDA_PELO_USUARIO_RECEBEDOR.object
Datas da cobrança (
criacao, expiracao).object
Dados da location do QR Code (
id, location, tipoCob).string
URL da location usada para renderizar o QR Code.
object
Dados do pagador (
cpf, nome).object
Valor da cobrança (
original).string
Chave Pix que recebe o pagamento.
string
Descrição do pagamento exibida ao cliente.
array
Informações internas adicionais (
nome, valor).array
string
Código Pix copia e cola da cobrança.
curl -X GET "https://api.pix.basspago.com.br/cob/a1b2c3d4e5f60718293a4b5c6d7e8f90" \
--cert ./client.crt \
--key ./client.key \
--pass "SUA_SENHA_DO_CERTIFICADO" \
-H "Authorization: Bearer {access_token}"
<?php
$txid = 'a1b2c3d4e5f60718293a4b5c6d7e8f90';
$ch = curl_init("https://api.pix.basspago.com.br/cob/{$txid}");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_SSLCERT => './client.crt',
CURLOPT_SSLKEY => './client.key',
CURLOPT_KEYPASSWD => 'SUA_SENHA_DO_CERTIFICADO',
CURLOPT_HTTPHEADER => ['Authorization: Bearer {access_token}'],
]);
$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 txid = "a1b2c3d4e5f60718293a4b5c6d7e8f90";
const { data } = await axios.get(
`https://api.pix.basspago.com.br/cob/${txid}`,
{
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": "CONCLUIDA",
"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"
}
],
"pix": [
{
"endToEndId": "E12345678202607211307a1b2c3d4e5f",
"txid": "a1b2c3d4e5f60718293a4b5c6d7e8f90",
"valor": "49.90",
"horario": "2026-07-21T13:07:22.000Z",
"infoPagador": "Pagamento referente ao pedido #90210"
}
],
"pixCopiaECola": "00020126580014br.gov.bcb.pix..."
}