Realizar um Pix por QR Code Dinâmico

Importante:

Para usar esta API, é necessário estar autenticado e incluir seu token de autenticação no cabeçalho da requisição. Consulte a documentação de Autenticação na plataforma para mais informações.

Autenticação.

A funcionalidade de pagamento de QR Code Pix dinâmico na GlobalSCM oferece aos usuários uma maneira rápida e conveniente de realizar transações financeiras seguras. Ao escanear ou inserir manualmente as informações do QR Code Pix dinâmico, os usuários podem efetuar pagamentos de forma instantânea e sem complicações, agregando valor e praticidade à experiência do cliente.

Um cliente da GlobalSCM deseja realizar o pagamento de uma compra em uma loja física que aceita QR Code Pix dinâmico como forma de pagamento. O cliente utiliza o aplicativo da GlobalSCM em seu dispositivo móvel para escanear o QR Code apresentado no ponto de venda. Após confirmar os detalhes da transação e autorizar o pagamento, a transação é processada com sucesso, e os fundos são transferidos para o comerciante.

A funcionalidade de pagamento de QR Code Pix dinâmico na GlobalSCM oferece uma experiência simplificada e segura para os usuários realizarem transações financeiras com facilidade e conveniência.

Como utilizar?

Para utilizar essa funcionalidade, siga estes passos simples. Abaixo, você encontrará exemplos de como realizar o processo de Criação de QRCode dinâmico.

Requisição de exemplo

Variavel	Tipo	Exemplo	Obs:	Obgt
Key	String	428455208000101
codeCategory	String	0000	Código da Categoria do Cliente Recebedor Valor default “0000”
receiverName	String	Fulano de Tal	Nome do recebedor
payerRequest	String	Pesquisa de Satisfação	Texto que será apresentado ao pagador.
payerCPF	String	55704384080	CPF Pagador. Sem formatação e sem zeros a esquerda. *Preenchido apenas se cnpj ausente
payerCNPJ	String		CNPJ Pagador. Sem formatação e sem zeros a esquerda. *Preenchido apenas se cpf ausente
payerName	String	Ciclano de Tal	Obrigatório quando “cpfPagador” ou “cnpjPagador” estiver preenchido
city	String	Sao Paulo	Nome da Cidade onde é efetuada transação
zipcode	String	012273200	CEP da localidade onde é efetuada transação. *Sem separação e hifens
initialAmount	Number	1000.01	Máximo 12 dígitos numéricos, sendo 2 dígitos para casas decimais, separados por ponto.
expirationQR	String	86400	Limite para expiração do QRCode, em segundos. * Se não for enviado será feito para 86400 segundos (1 dia)
transactionIdentification	String	DEXCORETESTE00000000000001	Identificador para Conciliação do Recebedor. * Alphanumerico de 26 caracteres
additionalData	Array de Objeto	[{"name":"Detalhe do Pagamento","value":"Cobrança de invoice"}]	Grupo de informações adicionais, a serem exibidas ao pagador. *Alguns bancos não aceitam quando não enviam null.
reusable	Boolean	false	Indica se o QrCode Dinâmico pode ser reutilizado, mediante a troca da referência. Valor padrão quando não informado “false”.

Criar QR Code dinâmico

post

Authorizations

Body

keystringRequired

codeCategorystringRequired

receiverNamestringRequired

payerRequeststringRequired

payerCPFstringRequired

payerCNPJstringRequired

citystringRequired

zipcodestringRequired

initialAmountnumberRequired

expirationQRstringRequired

transactionIdentificationstringRequired

reusablebooleanRequired

Responses

post

HTTPcURLJavaScriptPython

POST /internal/api/v1/payments/qrcode/dynamic HTTP/1.1
Host: sandbox.globalscm.app.br
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 448

{
  "key": "42845528000101",
  "codeCategory": "0000",
  "receiverName": "Fulano de Tal",
  "payerRequest": "Pesquisa de satisfação",
  "payerCPF": "55704384080",
  "payerCNPJ": "",
  "payerName": "Ciclano de Tal",
  "city": "Sao Paulo",
  "zipcode": "01227200",
  "initialAmount": 1000.01,
  "expirationQR": "86400",
  "transactionIdentification": "DEXCORETESTE000000001",
  "additionalData": [
    {
      "name": "Detalhes do Pagamento",
      "value": "Cobranca  de invoice de teste numero 0001"
    }
  ],
  "reusable": false
}

No content

JSON Retorno Sucesso

{
    "document": "DEXCORETESTE0000000000000001",
    "qrcode": "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",
    "pixCopyPaste": "00020101021226910014BR.GOV.BCB.PIX2569qrcode-h.globalscm.com.br/pix/v2/cob/598874d444a84d7abc250c5bb1d5658d5204000053039865802BR5909GlobalSCM6009Sao Paulo62070503***6304F605"
}