Home
SiteDashboardInternet Bank
Home
SiteDashboardInternet Bank
  1. Recebimento
  • Home
  • Embedded Bank
    • Guias
    • Autenticação
    • Paginação
    • Idempotência
    • Erros
    • Data e Hora
    • Eventos e Webhooks
    • Modelo de dados
      • Entidades
      • Contas
      • Plataforma
      • Número de conta
      • Transferências
      • Pix Internacional
      • Cross-Border (Pagamentos Internacionais)
    • Conta
      • Detalhes de uma empresa
      • Criar uma Empresa
      • /entities/person
  • Gateway (Obsoleto)
    • Autenticação
      • Recebendo um token de acesso
    • Conta
      • Dados da conta
      • Visualizar saldo na conta
    • PIX
      • Pagamento
        • Iniciando e Confirmando o PIX
        • Listando Pagamentos de PIX
        • Detalhe de um Pagamento PIX
      • Recebimento
        • Criando QRCode PIX
          POST
        • Listando QRCodes
          GET
        • Detalhe de um QRCode
          GET
        • Devolvendo PIX Recebido
          DELETE
        • Encontrando pix pelo EndToEndId
          GET
        • Inativando um QRCode
          PATCH
    • Transferências
      • Consulta conta disponível transferências
      • Transferências entre contas P2P
      • Transferências entre contas P2P por Lote
      • Transferências entre contas TED
    • Boletos
      • Retornando lista de boleto emitidos
      • Emitindo um boleto
      • Cancelando um boleto
    • Pagamentos de Títulos
      • Consulta código de barras
      • Pagamento código de barras
    • Webhook
      • Criando um webhook
      • Listando webhooks
      • Removendo webhook
    • HealthCheck
      GET
  • Core
  • Esquemas
    • bussines_entity
    • Address
  1. Recebimento

Criando QRCode PIX

POST
https://api.valut.baas/banking/pix/qrcode
Request Body:
propertytyperequireddescription
amountintegeryesValor para recebimento do PIX em centavos.
typestringyesTipo do PIX: "dynamic" ou "static".
external_idstringnoID de referência. Utilizado para idenficação do PIX na sua plataforma.
expiration_datedatetimenoData de expiração do PIX.
Observações:
1. Quando o expiration_date for menor que o tempo atual, será considerado PIX com tempo de expiração padrão do banco.
Response Body:
typedescription
pix_idintegerId do PIX.
typestringTipo do PIX: "dynamic" ou "static".
paidboolFlag para identificar o pagamento do PIX.
base64stringImagem em BASE64 do QRCode PIX.
qrcodestringQRCode PIX. Também conhecido como PIX Copia e Cola.
amountintegerValor em centavos;
expiration_datedatetimeData de expiração do PIX.
created_atdatetimeData de criação do PIX.
Habilitando retorno da imagem PIX
O Campo base64 funciona para facilitar o retorno do PIX, já retornando da API com a imagem para recebimento. Para habilitar essa funcionalidade deve enviar na QueryString o parâmetro withImage com o valor true.
Assim o response vai conter o campo base64, caso contrário esse campo será nulo.

Requisição

Authorization
Forneça seu token bearer no cabeçalho
Authorization
ao fazer requisições para recursos protegidos.
Exemplo:
Authorization: Bearer ********************
Parâmetros de Consulta

Parâmetros Bodyapplication/json

Examples

Respostas

🟢200Criando QRCode PIX
application/json
Body

🟢200Criando QRCode PIX - Imagem Base 64
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.valut.baas/banking/pix/qrcode?withImage=false' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "amount": 62,
  "type": "dynamic",
  "external_id": "15f5170b-a64e-47a3-8727-6608305728b3",
  "expiration_date": "2024-08-17 19:48:44"
}'
Response Response Example
200 - Criando QRCode PIX - Criando QRCode PIX
{
    "pix_id": "1112229912249ce869381ede361b7af",
    "type": null,
    "paid": false,
    "base64": null,
    "qrcode": "string",
    "amount": 5049,
    "expiration_date": "2022-01-12T14:50:35.0682132-03:00",
    "created_at": "2022-01-12T14:50:35.2221029-03:00"
}
Modificado em 2024-12-09 08:26:00
Página anterior
Detalhe de um Pagamento PIX
Próxima página
Listando QRCodes
Built with