Receber um Pix Cash-in por QR Code dinâmico

Essa funcionalidade é ideal para criar QR Codes de cobrança instantânea. Um caso de uso comum seria:

Como parte da GlobalSCM, desejo oferecer aos nossos usuários a capacidade de cobrar instantaneamente através de suas chaves Pix. Ao preencher o valor da transação, o sistema gerará um QR Code e o código "Pix Copia e Cola" correspondente para facilitar o pagamento da cobrança.

A funcionalidade de receber/gerar 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.

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

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

objectOptionalExample: {"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}

Responses

200

successful

No content

401

authorization failed

422

validation failed

500

unknown server error

post

https://sandbox.globalscm.app.br/internal/api/v1/payments/qrcode/dynamic

HTTPcURLJavaScriptPython

POST https://sandbox.globalscm.app.br/internal/api/v1/payments/qrcode/dynamic HTTP/1.1
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

Criar QR Code dinâmico

post

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

keystringRequired

codeCategorystringRequired

receiverNamestringRequired

payerRequeststringRequired

payerCPFstringRequired

payerCNPJstringRequired

citystringRequired

zipcodestringRequired

initialAmountnumberRequired

expirationQRstringRequired

transactionIdentificationstringRequired

reusablebooleanRequired

Responses

200

successful

No content

400

bad request

application/json

401

authorization failed

422

validation failed

500

unknown server error

application/json

post

/internal/api/v1/payments/qrcode/dynamic

HTTPcURLJavaScriptPython

POST /internal/api/v1/payments/qrcode/dynamic HTTP/1.1
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

Evento: pix_in

Verificar a documentação do Webhook.