Decodificar QRCode

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 GlobalSCM disponibiliza aos seus clientes a API de decodificação de QR Code, permitindo que o sistema consuma essa funcionalidade para decodificar tanto QR Codes estáticos quanto dinâmicos.

Um sistema cliente de uma Fintech envia uma solicitação à API de decodificação de QR Code da GlobalSCM, fornecendo um QR Code recebido de um cliente. A API processa o QR Code e extrai os dados relevantes, como informações do destinatário e valor da transação. Esses dados são então utilizados pelo sistema cliente para realizar ações como pagamento, registro de transação ou outras operações relacionadas.

A API de decodificação de QR Code da GlobalSCM oferece aos sistemas cliente uma maneira eficiente e confiável de extrair informações de QR Codes, facilitando a integração e automação de processos relacionados a pagamentos e transações financeiras.

Como utilizar?

Para utilizar essa funcionalidade, siga estes passos simples. Abaixo, você encontrará exemplos de como realizar o processo de abertura de conta.

Requisição de exemplo

Decodificar QRCode

post

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

objectOptionalExample: {"emv":"00020126830014br.gov.bcb.pix01364004901d-bd85-4769-8e52-cb4c42c506dc0221Jornada pagador 479635204000053039865406991.085802BR5903Pix6008BRASILIA62290525bac664e345ab419eb4637e68d6304E1E5"}

Responses

200

successful

application/json

endToEndIdstringOptionalExample: E11165756202503201534213J0HHWVPV

typeQrCodestringOptionalExample: STATIC

400

validation failed

application/json

401

authorization failed

application/json

500

unknown server error

application/json

post

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

HTTPcURLJavaScriptPython

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

{
  "emv": "00020126830014br.gov.bcb.pix01364004901d-bd85-4769-8e52-cb4c42c506dc0221Jornada pagador 479635204000053039865406991.085802BR5903Pix6008BRASILIA62290525bac664e345ab419eb4637e68d6304E1E5"
}

{
  "endToEndId": "E11165756202503201534213J0HHWVPV",
  "typeQrCode": "STATIC",
  "staticQrCodeData": {
    "ispb": 99999008,
    "key": "4004901d-bd85-4769-8e52-cb4c42c506dc",
    "categoryCode": "0000",
    "amount": 991.08,
    "receiverName": "QRTester",
    "cpfCnpjReceiver": "**.111.111/****-**",
    "city": "BRASILIA",
    "receiverReconciliationID": "bac664e345ab419eb4637e68d"
  }
}

JSON Retorno Sucesso

{
	"endToEndId": "E1116575620240302182504047362975",
	"typeQrcode": "STATIC",
	"staticQrCodeData": {
		"ispb": 99999008,
		"agencyNumber": "1",
		"accountType": "CORRENTE",
		"accountNumber": "12345678",
		"key": "4004901d-bd85-4769-8e52-cb4c42c506dc",
		"categoryCode": "0000",
		"amount": 991.08,
		"receiverName": "QRTester",
		"peopleType": "JURIDICA",
		"cpfCnpjReceiver": 11111111000191,
		"city": "BRASILIA",
		"receiverReconciliationID": "bac664e345ab419eb4637e68d"
	}
}

ou

{
	"endToEndId": "E1116575620240302182620927501252",
	"typeQrcode": "DYNAMIC",
	"dynamicQrCodeData": {
		"revision": 0,
		"ispb": 11165756,
		"agencyNumber": "1",
		"accountType": "CORRENTE",
		"accountNumber": "2",
		"key": "6acae863-5d86-43df-80c5-2210aedb2e80",
		"receiverReconciliationID": "DEXCORETESTE0000000000000001",
		"categoryCode": "0000",
		"receiverName": "DAVI CONSULIN",
		"peopleType": 1,
		"cpfCnpjReceiver": 41014420000104,
		"payerName": "Ciclano de Tal",
		"city": "Sao Paulo",
		"initialValue": 1000.01,
		"qrExpiration": 86400,
		"additionalData": [
			{
				"name": "Detalhes do Pagamento",
				"value": "Cobranca  de invoice de teste numero 0001"
			}
		],
		"dtHrCreation": "2024-03-02T15:24:20.000Z",
		"dtHrPresentation": "2024-03-02T18:26:20.939Z",
		"receiverPspUrl": "qrcode-h.globalscm.com.br/pix/v2/cob/598874d444a84d7abc250c5bb1d5658d",
		"reusable": false,
		"status": 0
	}
}