Transferir para QR Code

curl -X POST "https://pagamentos.basspago.com.br/api/v2/pix/payments/qrc" \
  --cert ./client.crt \
  --key ./client.key \
  --pass "SUA_SENHA_DO_CERTIFICADO" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-idempotency-key: 6a1f2e3d-4c5b-6a7f-8e9d-0a1b2c3d4e5f" \
  -d '{
    "priority": "NORM",
    "paymentFlow": "INSTANT",
    "expiration": 600,
    "payment": {
      "currency": "BRL",
      "amount": 150.00
    },
    "qrCode": "00020126580014br.gov.bcb.pix0136e3b0c442-98fc-4c1a-b2d6-9a7f5e10c3d4520400005303986540615.005802BR5913SUA LOJA LTDA6009SAO PAULO62070503***6304AB12"
  }'

<?php

$ch = curl_init('https://pagamentos.basspago.com.br/api/v2/pix/payments/qrc');

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}',
        'x-idempotency-key: 6a1f2e3d-4c5b-6a7f-8e9d-0a1b2c3d4e5f',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'priority' => 'NORM',
        'paymentFlow' => 'INSTANT',
        'expiration' => 600,
        'payment' => ['currency' => 'BRL', 'amount' => 150.00],
        'qrCode' => '00020126580014br.gov.bcb.pix0136e3b0c442-98fc-4c1a-b2d6-9a7f5e10c3d4520400005303986540615.005802BR5913SUA LOJA LTDA6009SAO PAULO62070503***6304AB12',
    ]),
]);

$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://pagamentos.basspago.com.br/api/v2/pix/payments/qrc",
  {
    priority: "NORM",
    paymentFlow: "INSTANT",
    expiration: 600,
    payment: { currency: "BRL", amount: 150.0 },
    qrCode:
      "00020126580014br.gov.bcb.pix0136e3b0c442-98fc-4c1a-b2d6-9a7f5e10c3d4520400005303986540615.005802BR5913SUA LOJA LTDA6009SAO PAULO62070503***6304AB12",
  },
  {
    httpsAgent: agent,
    headers: {
      Authorization: "Bearer {access_token}",
      "x-idempotency-key": "6a1f2e3d-4c5b-6a7f-8e9d-0a1b2c3d4e5f",
    },
  }
);

console.log(data);

{
  "id": "pay_1a2b3c4d5e6f",
  "status": "PROCESSING",
  "priority": "NORM",
  "paymentFlow": "INSTANT",
  "payment": {
    "currency": "BRL",
    "amount": 150.00
  },
  "qrCode": "00020126580014br.gov.bcb.pix0136e3b0c442-98fc-4c1a-b2d6-9a7f5e10c3d4520400005303986540615.005802BR5913SUA LOJA LTDA6009SAO PAULO62070503***6304AB12",
  "idempotencyKey": "6a1f2e3d-4c5b-6a7f-8e9d-0a1b2c3d4e5f",
  "createdAt": "2026-07-21T14:45:00Z"
}

POST

api

pix

payments

qrc

curl -X POST "https://pagamentos.basspago.com.br/api/v2/pix/payments/qrc" \
  --cert ./client.crt \
  --key ./client.key \
  --pass "SUA_SENHA_DO_CERTIFICADO" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-idempotency-key: 6a1f2e3d-4c5b-6a7f-8e9d-0a1b2c3d4e5f" \
  -d '{
    "priority": "NORM",
    "paymentFlow": "INSTANT",
    "expiration": 600,
    "payment": {
      "currency": "BRL",
      "amount": 150.00
    },
    "qrCode": "00020126580014br.gov.bcb.pix0136e3b0c442-98fc-4c1a-b2d6-9a7f5e10c3d4520400005303986540615.005802BR5913SUA LOJA LTDA6009SAO PAULO62070503***6304AB12"
  }'

<?php

$ch = curl_init('https://pagamentos.basspago.com.br/api/v2/pix/payments/qrc');

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}',
        'x-idempotency-key: 6a1f2e3d-4c5b-6a7f-8e9d-0a1b2c3d4e5f',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'priority' => 'NORM',
        'paymentFlow' => 'INSTANT',
        'expiration' => 600,
        'payment' => ['currency' => 'BRL', 'amount' => 150.00],
        'qrCode' => '00020126580014br.gov.bcb.pix0136e3b0c442-98fc-4c1a-b2d6-9a7f5e10c3d4520400005303986540615.005802BR5913SUA LOJA LTDA6009SAO PAULO62070503***6304AB12',
    ]),
]);

$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://pagamentos.basspago.com.br/api/v2/pix/payments/qrc",
  {
    priority: "NORM",
    paymentFlow: "INSTANT",
    expiration: 600,
    payment: { currency: "BRL", amount: 150.0 },
    qrCode:
      "00020126580014br.gov.bcb.pix0136e3b0c442-98fc-4c1a-b2d6-9a7f5e10c3d4520400005303986540615.005802BR5913SUA LOJA LTDA6009SAO PAULO62070503***6304AB12",
  },
  {
    httpsAgent: agent,
    headers: {
      Authorization: "Bearer {access_token}",
      "x-idempotency-key": "6a1f2e3d-4c5b-6a7f-8e9d-0a1b2c3d4e5f",
    },
  }
);

console.log(data);

{
  "id": "pay_1a2b3c4d5e6f",
  "status": "PROCESSING",
  "priority": "NORM",
  "paymentFlow": "INSTANT",
  "payment": {
    "currency": "BRL",
    "amount": 150.00
  },
  "qrCode": "00020126580014br.gov.bcb.pix0136e3b0c442-98fc-4c1a-b2d6-9a7f5e10c3d4520400005303986540615.005802BR5913SUA LOJA LTDA6009SAO PAULO62070503***6304AB12",
  "idempotencyKey": "6a1f2e3d-4c5b-6a7f-8e9d-0a1b2c3d4e5f",
  "createdAt": "2026-07-21T14:45:00Z"
}

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

Certificados

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

--cert

file

required

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

--key

file

required

Chave privada do cliente (client.key).

--pass

string

required

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

Headers

Content-Type

string

required

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

Authorization

string

required

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

x-idempotency-key

string

required

Chave única por transferência. Evita transferências duplicadas: se a mesma chave for reenviada, a transferência não é processada de novo.

Body

priority

string

Opções: HIGH ou NORM. Padrão: NORM.Com HIGH, o pagamento é processado instantaneamente e retornado na própria requisição (a requisição fica aberta até a transferência ser concluída). Com NORM, o pagamento é enfileirado e, após o processamento, o resultado é enviado por webhook.

paymentFlow

string

Opções: APPROVAL_REQUIRED ou INSTANT. Padrão: INSTANT.Com APPROVAL_REQUIRED, a transferência precisa de confirmação adicional para ser aprovada. Com INSTANT, a transferência é executada instantaneamente, sem necessidade de aprovação.

expiration

integer

Tempo em segundos que o saque pode ficar na fila de transferência antes de ser cancelado. Entre 1 e 10800. Só se aplica quando priority for NORM. Padrão: 600.

payment.currency

string

required

Moeda corrente do pagamento. Deve ser sempre "BRL".

payment.amount

number

required

Valor da transferência. Exemplo: 50.00.

qrCode

string

required

Código Pix copia e cola do QR Code a ser pago.

Resposta

string

Identificador da transferência na Super Finance.

status

string

Status da transferência. Exemplos: PROCESSING, LIQUIDATED, REJECTED.

priority

string

Prioridade aplicada (HIGH ou NORM).

paymentFlow

string

Fluxo aplicado (INSTANT ou APPROVAL_REQUIRED).

payment

object

Valor da transferência (currency, amount).

qrCode

string

Código Pix copia e cola pago.

idempotencyKey

string

Chave de idempotência usada na requisição.

createdAt

string

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

curl -X POST "https://pagamentos.basspago.com.br/api/v2/pix/payments/qrc" \
  --cert ./client.crt \
  --key ./client.key \
  --pass "SUA_SENHA_DO_CERTIFICADO" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-idempotency-key: 6a1f2e3d-4c5b-6a7f-8e9d-0a1b2c3d4e5f" \
  -d '{
    "priority": "NORM",
    "paymentFlow": "INSTANT",
    "expiration": 600,
    "payment": {
      "currency": "BRL",
      "amount": 150.00
    },
    "qrCode": "00020126580014br.gov.bcb.pix0136e3b0c442-98fc-4c1a-b2d6-9a7f5e10c3d4520400005303986540615.005802BR5913SUA LOJA LTDA6009SAO PAULO62070503***6304AB12"
  }'

<?php

$ch = curl_init('https://pagamentos.basspago.com.br/api/v2/pix/payments/qrc');

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}',
        'x-idempotency-key: 6a1f2e3d-4c5b-6a7f-8e9d-0a1b2c3d4e5f',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'priority' => 'NORM',
        'paymentFlow' => 'INSTANT',
        'expiration' => 600,
        'payment' => ['currency' => 'BRL', 'amount' => 150.00],
        'qrCode' => '00020126580014br.gov.bcb.pix0136e3b0c442-98fc-4c1a-b2d6-9a7f5e10c3d4520400005303986540615.005802BR5913SUA LOJA LTDA6009SAO PAULO62070503***6304AB12',
    ]),
]);

$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://pagamentos.basspago.com.br/api/v2/pix/payments/qrc",
  {
    priority: "NORM",
    paymentFlow: "INSTANT",
    expiration: 600,
    payment: { currency: "BRL", amount: 150.0 },
    qrCode:
      "00020126580014br.gov.bcb.pix0136e3b0c442-98fc-4c1a-b2d6-9a7f5e10c3d4520400005303986540615.005802BR5913SUA LOJA LTDA6009SAO PAULO62070503***6304AB12",
  },
  {
    httpsAgent: agent,
    headers: {
      Authorization: "Bearer {access_token}",
      "x-idempotency-key": "6a1f2e3d-4c5b-6a7f-8e9d-0a1b2c3d4e5f",
    },
  }
);

console.log(data);

{
  "id": "pay_1a2b3c4d5e6f",
  "status": "PROCESSING",
  "priority": "NORM",
  "paymentFlow": "INSTANT",
  "payment": {
    "currency": "BRL",
    "amount": 150.00
  },
  "qrCode": "00020126580014br.gov.bcb.pix0136e3b0c442-98fc-4c1a-b2d6-9a7f5e10c3d4520400005303986540615.005802BR5913SUA LOJA LTDA6009SAO PAULO62070503***6304AB12",
  "idempotencyKey": "6a1f2e3d-4c5b-6a7f-8e9d-0a1b2c3d4e5f",
  "createdAt": "2026-07-21T14:45:00Z"
}

Transferir para chave Consultar saldo

Guia de implementação

Transações

Transferências

Contestações

Certificados

Headers

Body

Resposta

​Certificados

​Headers

​Body

​Resposta

Certificados

Headers

Body

Resposta