> ## Documentation Index
> Fetch the complete documentation index at: https://docs-finance.superpagamentos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Transferir para QR Code

> Pague um QR Code Pix (Cash Out) a partir do código copia e cola.

<Info>
  Essa rota utiliza os certificados e o Bearer Token de **Cash Out**.
</Info>

## Certificados

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

<ParamField path="--cert" type="file" required>
  Certificado de Cash Out do cliente (`client.crt`).
</ParamField>

<ParamField path="--key" type="file" required>
  Chave privada do cliente (`client.key`).
</ParamField>

<ParamField path="--pass" type="string" required>
  Senha para descriptografar a chave `.key`, enviada por e-mail junto com os certificados.
</ParamField>

## Headers

<ParamField header="Content-Type" type="string" required>
  Formato do corpo da requisição. Use `application/json`.
</ParamField>

<ParamField header="Authorization" type="string" required>
  Bearer Token de Cash Out. Formato: `Bearer {access_token}`.
</ParamField>

<ParamField header="x-idempotency-key" type="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.
</ParamField>

## Body

<ParamField body="priority" type="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.
</ParamField>

<ParamField body="paymentFlow" type="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.
</ParamField>

<ParamField body="expiration" type="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`.
</ParamField>

<ParamField body="payment.currency" type="string" required>
  Moeda corrente do pagamento. Deve ser sempre `"BRL"`.
</ParamField>

<ParamField body="payment.amount" type="number" required>
  Valor da transferência. Exemplo: `50.00`.
</ParamField>

<ParamField body="qrCode" type="string" required>
  Código Pix copia e cola do QR Code a ser pago.
</ParamField>

## Resposta

<ResponseField name="id" type="string">
  Identificador da transferência na Super Finance.
</ResponseField>

<ResponseField name="status" type="string">
  Status da transferência. Exemplos: `PROCESSING`, `LIQUIDATED`, `REJECTED`.
</ResponseField>

<ResponseField name="priority" type="string">
  Prioridade aplicada (`HIGH` ou `NORM`).
</ResponseField>

<ResponseField name="paymentFlow" type="string">
  Fluxo aplicado (`INSTANT` ou `APPROVAL_REQUIRED`).
</ResponseField>

<ResponseField name="payment" type="object">
  Valor da transferência (`currency`, `amount`).
</ResponseField>

<ResponseField name="qrCode" type="string">
  Código Pix copia e cola pago.
</ResponseField>

<ResponseField name="idempotencyKey" type="string">
  Chave de idempotência usada na requisição.
</ResponseField>

<ResponseField name="createdAt" type="string">
  Data e hora de criação (ISO 8601).
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  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 PHP theme={null}
  <?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;
  ```

  ```javascript Node.js theme={null}
  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);
  ```
</RequestExample>

<ResponseExample>
  ```json 200 - OK theme={null}
  {
    "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"
  }
  ```
</ResponseExample>