Gateway Crédito Direto
Entrar

API do Gateway

QR Codes

QR Pix estático e cobrança imediata, com payload EMV e imagem em base64.

GET/qr-codesAutenticado

Listar QR Codes

Lista QR Codes Pix estáticos e de cobrança imediata da conta.

https://gateway.credito-direto.com/api/qr-codes

cURL

cURL
curl --request GET \
  --url 'https://gateway.credito-direto.com/api/qr-codes' \
  --header 'accept: application/json' \
  --header 'authorization: Bearer TOKEN'

Exemplo de resposta

Response JSON
{
  "items": [
    {
      "id": "qr_01",
      "qrcode_type": "COBRANCA_IMEDIATA",
      "status": "ATIVA",
      "txid": "TXID123",
      "pix_key": { "id": "key_01", "key": "recebe@credito-direto.com", "key_type": "EMAIL" },
      "original_value": 50.0,
      "emv_payload": "00020126...",
      "image_base64": "iVBORw0KGgo...",
      "created_at": "2026-08-21T11:00:00.000Z",
      "updated_at": "2026-08-21T11:00:00.000Z"
    }
  ]
}
GET/qr-codes/:idAutenticado

Obter QR Code

Retorna payload EMV, imagem e status de um QR Code.

https://gateway.credito-direto.com/api/qr-codes/:id

cURL

cURL
curl --request GET \
  --url 'https://gateway.credito-direto.com/api/qr-codes/:id' \
  --header 'accept: application/json' \
  --header 'authorization: Bearer TOKEN'

Parâmetros de caminho

CampoTipoObrigatórioDescrição
idstringSimIdentificador do QR Code.
POST/qr-codesAutenticado

Criar QR Code

Gera QR estático (`ESTATICO`) ou cobrança imediata (`COBRANCA_IMEDIATA`). Valores deste recurso são em reais, não em centavos.

https://gateway.credito-direto.com/api/qr-codes

cURL

cURL
curl --request POST \
  --url 'https://gateway.credito-direto.com/api/qr-codes' \
  --header 'accept: application/json' \
  --header 'authorization: Bearer TOKEN' \
  --header 'content-type: application/json' \
  --data '{ "type": "COBRANCA_IMEDIATA", "pix_key": "recebe@credito-direto.com", "original_value": 50.0, "expiration": 3600, "payer": { "name": "Ana Costa", "document": "32165498700" } }'

Corpo da requisição

CampoTipoObrigatórioDescrição
type"ESTATICO" | "COBRANCA_IMEDIATA"SimDefine o formato do corpo da requisição (união discriminada).
pix_keystringSimChave Pix de recebimento.
valuenumberNãoESTATICO: valor em reais (opcional — omita para valor aberto).
additional_infostringNãoESTATICO: informação extra, máximo 37 caracteres.
original_valuenumberNãoCOBRANCA_IMEDIATA: valor original em reais (obrigatório nesse tipo).
payer_questionstringNãoCOBRANCA_IMEDIATA: mensagem ao pagador.
expirationintegerNãoCOBRANCA_IMEDIATA: expiração em segundos.
payerobjectNãoCOBRANCA_IMEDIATA: { name, document } do pagador.
integration_idstringNãoSeu identificador interno.

Exemplo de requisição

Body JSON
{
  "type": "COBRANCA_IMEDIATA",
  "pix_key": "recebe@credito-direto.com",
  "original_value": 50.0,
  "expiration": 3600,
  "payer": {
    "name": "Ana Costa",
    "document": "32165498700"
  }
}
  • Diferente de cobranças e lotes, `value` e `original_value` aqui são em reais (ex.: `50.0` = R$ 50,00).
DELETE/qr-codes/:idAutenticado

Revogar QR Code

Invalida o QR Code. Pagamentos já recebidos não são estornados.

https://gateway.credito-direto.com/api/qr-codes/:id

cURL

cURL
curl --request DELETE \
  --url 'https://gateway.credito-direto.com/api/qr-codes/:id' \
  --header 'accept: application/json' \
  --header 'authorization: Bearer TOKEN'

Parâmetros de caminho

CampoTipoObrigatórioDescrição
idstringSimIdentificador do QR Code.