HomeSiteDashboardInternet Bank
HomeSiteDashboardInternet Bank
  1. Recebimento
  • Core
    • oAuth
      • oauth2/token
      • oauth2/refresh_token
      • account/forgot_password
      • account/change_password
    • account
      • notifications
        • account/notifications
        • account/notifications/config
        • account/notifications/config
        • account/notifications/{id}/read
      • account/me
      • account/balance
      • account/balances
      • account/statement
      • account/last_statement
      • account/products
      • account/send_phone_code
      • account/register (cpf)
      • account/register (cnpj)
      • account/verifie_phone_code
      • account/upload_docs
      • account/transactional_password
      • account/check_document
      • account/profile_photo
      • account/rating
      • account/transactional_password
      • account/verifie_transactional_password
      • account/phone
      • account/phone/validate
      • account/password
      • account/tooltip
      • account/profile_photo
      • account/country
      • account/report
      • account/active
    • health
      • status
    • id
      • id/token
      • id/verifie_token
      • id/transactional_password
      • id/verifie_essential
    • version
      • version/app
    • Ultils
      • country
    • Representative
      • Add Lead
      • Add Lead Copy
      • root_account
    • validations
      • account/check_phone_number
      • account/check_email
      • account/search_postal_code
    • banking
      • institutions
      • /institutions/{id}
      • /institutions/{bankId}/branch/{code}
  • OpenBanking
    • 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
  1. Recebimento

Criando QRCode PIX

Production
https://api.valut.app/openbank/v1
Production
https://api.valut.app/openbank/v1
POST
https://api.valut.app/openbank/v1
/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 Query
withImage
string 
requerido
Exemplo:
false
Parâmetros Bodyapplication/json
amount
integer 
requerido
type
string 
requerido
external_id
string 
requerido
expiration_date
string 
requerido
Exemplo
{
  "amount": 62,
  "type": "dynamic",
  "external_id": "15f5170b-a64e-47a3-8727-6608305728b3",
  "expiration_date": "2024-08-17 19:48:44"
}

Exemplos de Requisição

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.valut.app/openbank/v1/banking/pix/qrcode?withImage=false' \
--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"
}'

Respostas

🟢200Criando QRCode PIX
application/json
Body
pix_id
string 
requerido
type
null 
requerido
paid
boolean 
requerido
base64
null 
requerido
qrcode
string 
requerido
amount
integer 
requerido
expiration_date
string 
requerido
created_at
string 
requerido
Exemplo
{
    "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"
}
🟢200Criando QRCode PIX - Imagem Base 64
Modificado em 2024-12-09 08:26:00
Página anterior
Detalhe de um Pagamento PIX
Próxima página
Listando QRCodes
Built with