Technical Manual ONLINE ISSUANCE BY HSBC LINK

Transcription

1 Technical Manual ONLINE ISSUANCE BY HSBC LINK Gateway of Payments HSBC Non Registered Collection PUBLIC Version: 25 Jul/2014

2 SUMMARY PRESENTATION 03 1 PRELIMINARY NOTES 04 2 LEGISLATION 05 3 PROCESS OF SERVICE HIRING 05 4 INTERFACE OF CUSTOMER ELETRONIC 06 5 MATURITY DATE 08 6 DOCUMENT NUMBER 08 7 INSTRUCTIONS 08 8 DRAWEE DATA 08 9 RE-ISSUANCE HSBC LOGO TESTS ANNEX I Integration Check List ANNEX Il Example of ASP Development ANNEX lll Example of PHP Development ANNEX IV Example of JSP Development ANNEX V Example of ASPNET/C# Development GLOSSARY 20 Copyright HSBC Bank Brazil SA - Banco Múltiplo - All rights reserved PUBLIC - 2

3 ONLINE ISSUANCE BY HSBC LINK - NON REGISTERED COLLECTION PRELIMINARY NOTES BLOQUETO FILLING PRESENTATION Dear Customer We, from HSBC Bank Brasil SA Branch Múltiplo are handling the Technical Manual Volume of Non Registered Collection - On-line Issuance by HSBC Link Through it, the people in charge of giving you computing support will have the necessary instructions to keep the integration with quality and agility of our services The Technical Manual of Non Registered Collection On-line Issuance by HSBC Link provides all the information so that the bloqueto issuance of collection can be done in your processing environment, which will provide agility and efficiency while collecting your on line sales If you have doubts, contact your manager Copyright HSBC Bank Brazil SA - Banco Múltiplo - All rights reserved PUBLIC - 3

4 1 PRELIMINARY NOTES The words with an asterisk (*) have the meaning in the glossary WHAT IS THE NON REGISTERED COLLECTION? The Non Registered Collection On-line Issuance by HSBC Link is HSBC Collection modality, and objectifies to attend the customers who carry out on line sales and want to offer this manner of payment to their clients Thereby, the on line bloqueto* issuance is made on the HSBC systems, with the data given by the customer, offering a bloqueto image on the internet, to be printed by its clients The client does not have to develop on his system the intelligence of formatting of bloqueto and the bar code To operate the information interchange that the customer Will know which issued bloquetos by the HSBC link were paid, this manual is complemented by the Technical Manual Standard CNAB 400 or CNAB 240 Copyright HSBC Bank Brazil SA - Banco Múltiplo - All rights reserved PUBLIC - 4

5 2 LEGISLATION The words with an asterisk (*) have the meaning in the glossary The standardization of Collection bloqueto*, specifically of Clearing Form, obeys the model CADOC , established by Banco Central do Brasil, through the Circular Letter 2414, on October, 7th, 1993, and modified by the Circular Letter 2790 on March, 3rd, 1998 Changing the specifications of Bar code, with the introduction of Auto-digit conference (DAC), occurred by Circular Letter No 2,531 the Bank on February, 24th, 1995 The changes on the specifications of Bar Code, with the introduction of Maturity Factor on collection bloquetos, occurred by the Circular Letter 125 of Banco Central do Brasil, on May,2 nd, PROCESS OF SERVICE HIRING The Customer must hire the Non Registered Collection offers by HSBC This volume of collection is the most recommended because in sales by internet, the good is only delivered or the service is only done after the payment confirmation The bloqueto nonpayment issued on internet do not characterize debt, therefore, there cannot be process of protest by the buyer The customer also signs the Contract of Services Deliver for Releasing of Collection Bloquetos by Electronic Way After the Non Registered Collection hire, the HSBC will define the ASSIGNOR CODE and will inform it for the Customer The customer must inform the IP number (s) of his servants for the bank, that use them as a security parameter, There is no quantity limit of IPs that can be registered The reason is that the solution requires the assignor Web servant opens a direct connection (Server-to-server) with the HSBC servant This connection is only accepted if the IP of origin is registered (See the item Interface of Customer Electronic Commerce with HSBC) Copyright HSBC Bank Brazil SA - Banco Múltiplo - All rights reserved PUBLIC - 5

6 4 INTERFACE OF CUSTOMER ELECTRONIC COMMERCE WITH HSBC The On Line Issuance process works according to the following way: (see picture) 1 DRAWEE access the company site and makes his buying 2 DRAWEE, after registering on the assignor site, selects the payment form (Clearing Bloqueto) 3 DRAWEE carries out a submit for a link lodged on the assignor servant 4 The assignor servant carries out a direct connection (Server-to-Server) via post (see item Observations, below the item 9) for the address 5 The post sent to the Customer Servant for the HSBC link must contain the following data so that the bloqueto generation can occur successfully: Field Name Type of Data Size Format Filling Mandatory? Observation codigocedente NUMERIC S datavencimento DATE 10 DD/MM/YYYY S valordocumento ALPHANUMERIC S numeroparcela NUMERIC N totalparcelas NUMERIC N numerodocumento NUMERIC S L1 ALPHANUMERIC 66 N Messages L2 ALPHANUMERIC 66 N L3 ALPHANUMERIC 66 N L4 ALPHANUMERIC 66 N L5 ALPHANUMERIC 66 N unidadecedente ALPHANUMERIC 54 N nomesacado ALPHANUMERIC 30 S cpfcnpjsacado NUMERIC S enderecosacado ALPHANUMERIC 40 N numerosacado NUMERIC 05 N complementosacado ALPHANUMERIC 10 N cepsacado ALPHANUMERIC N bairrosacado ALPHANUMERIC 15 N cidadesacado ALPHANUMERIC 15 N estadosacado ALPHANUMERIC 02 N that will be not shown on the bloqueto Attention: the capital and the lower case letters must be respected, for URL as well as from the parameter name of the post The field indicated on the table above with Mandatory Filling n must be generated with a blank content 6 HSBC validates if the assignor is registered and if the requisition has as the origin the assignor servants Copyright HSBC Bank Brazil SA - Banco Múltiplo - All rights reserved PUBLIC - 6

7 7 HSBC obtains the assignor information, the typed line and the bar code and sets the bloqueto 8 HSBC gives the PDF content back with the bloqueto generates for the Customer servant 9 The assignor servant captures the PDF generated and presents it in a proper page (lodged on his servant) Observation: - The data informed by the assignor are not validated by HSBC (drawee, value, date of maturity, etc) Therefore, it is the Customer responsibility to send them correctly - Important: The call for the HSBC URL must be carried out internally through a connection Server-to-Server from the assignor servant to the HSBC servant If the assignor releases the HSBC link on his own page (example: if the HSBC URL is put as Action from a HTML form ), the bloqueto will not be generates, because on this case, the requisition/ connection will be leaving form the drawee IP and not from the assignor servant IP See the following picture: 1 Carries out a requisition for a page lodged on the assignor servant 2 Assignor carries out an INTERN REQUISITION for the generation link of HSBC bloqueto DRAWEE ASSIGNOR HSBC 5 Assignor presents the bloqueto generated as if it was generated on its own servant 4 Assignor captures the returned PDF and presents it on a page lodged on its own servant 3 HSBC gives back with the generated bloqueto Copyright HSBC Bank Brazil SA - Banco Múltiplo - All rights reserved PUBLIC - 7

8 5 Maturity Date It is recommended that the maturity date defined by the customer must be always on the Day after the buying or more, in order to enable to the customer the payment, if he makes the buying after the time of banking expedient 6 Document Number - Field numberdocument This number is unique for the bloquetoit must be controlled by the customer and will be used on the conciliation of settled payments, because it will be sent to the Customer on the settlement return file 7 Instructions The instruction field has the purpose of leading the cashier about the bloqueto receipt To compose the group of messages, the customer can use as a model the standard instructions listed on the section Table of Informative Notes- note 9 from the Technical Manual Volume I, CNAB 400 Standard The instructions will be sent on the fields L1, L2, L3, L4 e L5 of the message 8 Drawee Data As the bloqueto will be issued by the site, drawee data besides the name and the CPF*/CNPJ* are not mandatory 9 RE-ISSUANCE It is suggested to the Customer to set on his site, in a accessible form to the consumer, the possibility or issuing again the banking bloqueto related to his buying, avoiding losses on the bloqueto which can become in losses of sales from the customer The re issuance link must repeat the process of call on the HSBC site, with a new maturity date, if necessary, in order to enable the payment in any branch of any bank 10 HSBC LOGO Occasionally it is possible to use the HSBC logo to indicate the option of payment with bloqueto If the customer wishes to use it, He must contact the manager for orientations Copyright HSBC Bank Brazil SA - Banco Múltiplo - All rights reserved PUBLIC - 8

9 11 TESTS Before setting this payment option by banking bloqueto on his site, the customer must wait for the manager signal To initiate the connection tests, in order to have the appropriate technical homologation This procedure is indispensable to guarantee the connection quality and the bloqueto generation It is recommended to the customer to certify that the Check list of integration (Annex I) has been verified Copyright HSBC Bank Brazil SA - Banco Múltiplo - All rights reserved PUBLIC - 9

10 12 ANNEX I - Integration Check list 1 The connection must be mandatorily SSL (Door 443) The parameter names, principally the ServletState and the assignor code must respect the nomenclature defined on the integration document, including capital 2 and lower case letters The ServletState must be passed with the address (URL), and the others on the Post line When the HSBC receives the HTTP Post request, validates if the IP of connection origin is the IP which is registered on the system, namely, the Web servant IP of the customer 3 It does not work if it is done a redirect or any other type of call that is directly from the customer browser for our system (Referrer, JavaScript, etc) (See the pictures at the end of this document) Parameters values on Post querystring must be URLEncoded according to the format MIME application/x-www-form-urlencoded Example: spaces do not 4 converted for +, special letters are converted to %xy, where xy is the hexadecimal code of letter, etc Details/ Solution example The program of the store, which runs on the servant (JSP, ASP, CGI) must have a logical similar to the following: var resulthsbc=executepostparaurldohsbc(parameters,); printoutputforcustomer(resulthsbc); On this example, the variable resulthsbc, after executed the passage, would be loaded with the HSBC URL answer On this way, who makes the Post for HSBC is the servant of store lodging, and not the customer browser The Post result is included dynamically, by the store system, on the page content for the customer For example: See pictures below Copyright HSBC Bank Brazil SA - Banco Múltiplo - All rights reserved PUBLIC - 10

13 13 ANNEX II - Example of ASP development <%@language=vbscript%> <html> <head> <title>gera_boleto</title> <style> body { margin: 20px; font: 11px sans-serif; color: #000; th { font: bold 11px sans-serif; color: #000; padding: 4px 10px; border-bottom: 1px solid #9E9E9E; td { font: 11px sans-serif; color: #000; text-align: right; padding: 4px 10px; border-bottom: 1px solid #9E9E9E; hr { border: 10px 0 20px 0; color: #9E9E9E; background-color: #9E9E9E; height: 1px; width: 100%; #erro { font: bold 16px sans-serif; color: #F00 tit { font: bold 16px sans-serif; color: #000; </style> </head> <body> <% ServerScriptTimeout = 300 '####################################################### '### CONEXÃO MSXML2 PARA BUSCAR DADOS '####################################################### set xmlhttp = CreateObject("MSXML2ServerXMLHTTP") on error resume next '####################################################### '### CONEXÃO PARA PASSAR PARAMETROS E RECEBER O HTML '####################################################### codigocedente = " " datavencimento = "10/02/2008" valordocumento = " " numeroparcela = "01" totalparcelas = "02" numerodocumento = " " L1 = "Senhor(a) Caixa, favor seguir as instruções abaixo:" L2 = "1 Não receber este documento após a data de seu vencimento" L3 = "2 Valores expressos em Reais" L4 = "3 Não receber por depósito bancário" L5 = "Reader's Digest Brasil" unidadecedente = "NOME FAKE DO BRASIL" nomesacado = "NOME FAKE DA SILVA" cpfcnpjsacado = " " enderecosacado = "RUA DO CARMO" numerosacado = "43" complementosacado = "10 ANDAR" cepsacado = " " bairrosacado = "CENTRO" cidadesacado = "RIO DE JANEIRO" estadosacado = "RJ" url = " xmlhttpopen "POST", url, false xmlhttpsetrequestheader "Content-Type", "application/x-www-form-urlencoded" xmlhttpsend "codigocedente=" & codigocedente& "&datavencimento=" & datavencimento & "&valordocumento=" & valordocumento & "&numeroparcela=" & numeroparcela& "&totalparcelas=" & totalparcelas & "&numerodocumento=" & numerodocumento & "&L1=" & L1 & "&L2=" & L2 & "&L3=" & L3 & "&L4=" & L4 & "&L5=" & L5 & "&unidadecedente=" & unidadecedente & "&nomesacado=" & nomesacado & "&cpfcnpjsacado=" & cpfcnpjsacado & "&enderecosacado=" & enderecosacado & "&numerosacado=" & numerosacado & "&complementosacado=" & complementosacado & "&cepsacado=" & cepsacado & "&bairrosacado=" & bairrosacado & "&cidadesacado=" & cidadesacado & "&estadosacado=" & estadosacado //boleto = xmlhttpresponsetext //ResponseWrite "retorno: " & boleto ResponseContentType = "application/pdf" //To open the file in browser, define the property below as "inline" //To force file download, define the property below as "attachment" //To define the file name, define the property filename below the desired name, // in this case it is defined as BoletoHSBCpdf but could be any file name that better // suits the customer needs //If you do not want to define a file name, just leave it blank or erase the property filename below ResponseAppendHeader("content-disposition", "inline;filename=boletohsbcpdf"); Copyright HSBC Bank Brazil SA - Banco Múltiplo - All rights reserved PUBLIC - 13

14 ResponseBinaryWrite xmlhttpresponsebody set xmlhttp = nothing %> </body> </html> Observation: The example above is for the solution understanding, and not for the use exactly as it is Copyright HSBC Bank Brazil SA - Banco Múltiplo - All rights reserved PUBLIC - 14

15 14 ANNEX III - Example of PHP development <?php $sock = fsockopen("ssl://wwws5hsbccombr", 443, $errno, $errstr, 30); if(!$sock) die ("$errstr ($errno)\n"); $data = "ServletState=10&codigoCedente= &datavencimento=30/08/2007&valordocumento=100&numeroparcela=1&totalparcelas=1&numerodocumento= &l 1=Instrução1&L2=Instrução 2&L3=Instrução 3&L4=Instrução 4&L5=Instrução5&unidadeCedente=01&nomeSacado=Alexandre&cpfCnpjSacado= &enderecoSacado=Rua Cel de tal, Apto2&numeroSacado=&complementoSacado=&cepSacado= &bairroSacado=Belenzinho&cidadeSacado=São Paulo&estadoSacado=SP"; $d1 = explode('&', $data); $data = ""; for($i=0;$i<sizeof($d1);$i++) { list($field, $value) = explode('=', $d1[$i]); $data = $field "=" urlencode($value) "&"; fputs($sock, "POST /OFB-BOL-CNR/servlets/GeraBoleto HTTPS/10\r\n"); fputs($sock, "Host: wwws5hsbccombr\r\n"); fputs($sock, "Content-type: application/x-www-form-urlencoded\r\n"); fputs($sock, "Content-length: " strlen($data) "\r\n"); fputs($sock, "Accept: */*\r\n"); fputs($sock, "\r\n"); fputs($sock, "$data\r\n"); fputs($sock, "\r\n"); $headers = ""; while ($str = trim(fgets($sock, 4096))) { $headers = "$str\n"; $body = ""; while (!feof($sock)) { $body = fgets($sock, 4096); fclose($sock); /** * Cabeçalho de resposta * */ //print "\n\n"; /** * Corpo do documento retornado * */ print $body;?> Observation: The example above is for solution understanding to be developed and not for the use exactly as it is Copyright HSBC Bank Brazil SA - Banco Múltiplo - All rights reserved PUBLIC - 15

16 15 ANNEX IV - Example of JSP development <%@ page language="java" contenttype="text/html; charset=iso " pageencoding="iso "%> <%@page import="javaneturl" %> <%@page import="javaneturlencoder" %> <%@page import="javaneturlconnection" %> <%@page import="javaiooutputstreamwriter" %> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 401 Transitional//EN" " <%@page import="javaiodatainputstream"%> <html> <head> <title>jsp Form Demo</title> <style type="text/css"> label{ margin-right:20px; input{ margin-top:5px; </style> </head> <body> <b>página Encontrada!</b> <% Systemoutprintln("Preparando chamada"); String val = requestgetparameter("issubmitted"); int issubmitted = 0; if (val!= null) { Systemoutprintln("Preparando dados"); issubmitted = IntegerparseInt(val); if (issubmitted == 1) { String codigocedente = " "; String datavencimento = "10/02/2008"; String valordocumento = " "; String numeroparcela = "01"; String totalparcelas = "02"; String numerodocumento = " "; String L1 = "Senhor(a) Caixa, favor seguir as instruções abaixo:"; String L2 = "1 Não receber este documento após a data de seu vencimento"; String L3 = "2 Valores expressos em Reais"; String L4 = "3 Não receber por depósito bancário"; String L5 = "Reader's Digest Brasil"; String unidadecedente = "NOME FAKE DO BRASIL"; String nomesacado = "NOME FAKE DA SILVA"; String cpfcnpjsacado = " "; String enderecosacado = "RUA DO CARMO"; String numerosacado = "43"; String complementosacado = "10 ANDAR"; String cepsacado = " "; String bairrosacado = "CENTRO"; String cidadesacado = "RIO DE JANEIRO"; String estadosacado = "RJ"; 8"); 8"); "UTF-8"); 8"); "UTF-8"); String data = URLEncoderencode("codigoCedente", "UTF-8") + "=" + URLEncoderencode(codigoCedente, "UTF-8"); data += "&" + URLEncoderencode("dataVencimento", "UTF-8") + "=" + URLEncoderencode(dataVencimento, "UTF- data += "&" + URLEncoderencode("valorDocumento", "UTF-8") + "=" + URLEncoderencode(valorDocumento, "UTF- data += "&" + URLEncoderencode("numeroParcela", "UTF-8") + "=" + URLEncoderencode(numeroParcela, "UTF-8"); data += "&" + URLEncoderencode("totalParcelas", "UTF-8") + "=" + URLEncoderencode(totalParcelas, "UTF-8"); data += "&" + URLEncoderencode("numeroDocumento", "UTF-8") + "=" + URLEncoderencode(numeroDocumento, data += "&" + URLEncoderencode("L1", "UTF-8") + "=" + URLEncoderencode(L1, "UTF-8"); data += "&" + URLEncoderencode("L2", "UTF-8") + "=" + URLEncoderencode(L2, "UTF-8"); data += "&" + URLEncoderencode("L3", "UTF-8") + "=" + URLEncoderencode(L3, "UTF-8"); data += "&" + URLEncoderencode("L4", "UTF-8") + "=" + URLEncoderencode(L4, "UTF-8"); data += "&" + URLEncoderencode("L5", "UTF-8") + "=" + URLEncoderencode(L5, "UTF-8"); data += "&" + URLEncoderencode("unidadeCedente", "UTF-8") + "=" + URLEncoderencode(unidadeCedente, "UTF- data += "&" + URLEncoderencode("numeroDocumento", "UTF-8") + "=" + URLEncoderencode(numeroDocumento, Copyright HSBC Bank Brazil SA - Banco Múltiplo - All rights reserved PUBLIC - 16

17 8"); data += "&" + URLEncoderencode("nomeSacado", "UTF-8") + "=" + URLEncoderencode(nomeSacado, "UTF-8"); data += "&" + URLEncoderencode("cpfCnpjSacado", "UTF-8") + "=" + URLEncoderencode(cpfCnpjSacado, "UTF-8"); data += "&" + URLEncoderencode("enderecoSacado", "UTF-8") + "=" + URLEncoderencode(enderecoSacado, "UTF- data += "&" + URLEncoderencode("numeroSacado", "UTF-8") + "=" + URLEncoderencode(numeroSacado, "UTF-8"); data += "&" + URLEncoderencode("complementoSacado", "UTF-8") + "=" + URLEncoderencode(complementoSacado, "UTF-8"); data += "&" + URLEncoderencode("cepSacado", "UTF-8") + "=" + URLEncoderencode(cepSacado, "UTF-8"); data += "&" + URLEncoderencode("bairroSacado", "UTF-8") + "=" + URLEncoderencode(bairroSacado, "UTF-8"); data += "&" + URLEncoderencode("cidadeSacado", "UTF-8") + "=" + URLEncoderencode(cidadeSacado, "UTF-8"); data += "&" + URLEncoderencode("estadoSacado", "UTF-8") + "=" + URLEncoderencode(estadoSacado, "UTF-8"); %> </body> </html> // Enviado Dados para a emissão do boleto Systemoutprintln("Montando URL de conexão"); URL url = new URL(" // Montando a conexão com o Servidor URLConnection conn = urlopenconnection(); connsetdoinput(true); connsetdooutput(true); connsetrequestproperty("content-type", "application/x-www-form-urlencoded"); OutputStreamWriter wr = new OutputStreamWriter(conngetOutputStream()); DataInputStream input; Systemoutprintln("Enviando dados"); wrwrite(data); wrflush(); // Get response data Systemoutprintln("Retorno da chamada "); input = new DataInputStream (conngetinputstream ()); BufferedOutputStream bufferedoutputstream = new BufferedOutputStream(responsegetOutputStream()); int bytesread = 0; byte[] buffer = new byte[1024]; responsesetcontentlength(connectiongetcontentlength()); responsesetcontenttype("application/pdf"); //To open the file in browser, define the property below as "inline" //To force file download, define the property below as "attachment" //To define the file name, define the property filename below the desired name, // in this case it is defined as BoletoHSBCpdf but could be any file name that better // suits the customer needs //If you do not want to define a file name, just leave it blank or erase the property filename below responsesetheader("content-disposition", "inline; filename=boletohsbcpdf"); responsesetheader("cache-control", "cache, must-revalidate"); responsesetheader("pragma", "public"); while ((bytesread = bufferedinputstreamread(buffer))!= -1) { bufferedoutputstreamwrite(buffer, 0, bytesread); bufferedoutputstreamflush(); inputclose (); Observation: The example above is for solution understanding to be developed and not for the use exactly as it is Copyright HSBC Bank Brazil SA - Banco Múltiplo - All rights reserved PUBLIC - 17

18 16 ANNEX V - Example ASPNET/C# development using System; using SystemCollectionsGeneric; using SystemLinq; using SystemWeb; using SystemWebUI; using SystemWebUIWebControls; namespace TesteWeb { public partial class _Default : SystemWebUIPage { protected void Page_Load(object sender, EventArgs e) { protected void Button1_Click(object sender, EventArgs e) { if (txttestetext!= "") { string url = " chamaurl(url); private void chamaurl(string url) { String codigocedente = " "; String datavencimento = "10/02/2008"; String valordocumento = " "; String numeroparcela = "01"; String totalparcelas = "02"; String numerodocumento = " "; String L1 = "Senhor(a) Caixa, favor seguir as instruções abaixo:"; String L2 = "1 Não receber este documento após a data de seu vencimento"; String L3 = "2 Valores expressos em Reais"; String L4 = "3 Não receber por depósito bancário"; String L5 = "Reader's Digest Brasil"; String unidadecedente = "NOME FAKE DO BRASIL"; String nomesacado = "NOME FAKE DA SILVA"; String cpfcnpjsacado = " "; String enderecosacado = "RUA DO CARMO"; String numerosacado = "43"; String complementosacado = "10 ANDAR"; String cepsacado = " "; String bairrosacado = "CENTRO"; String cidadesacado = "RIO DE JANEIRO"; String estadosacado = "RJ"; String data = "codigocedente" + "=" + codigocedente ; data += "&" + "datavencimento" + "=" + datavencimento; data += "&" + "valordocumento" + "=" + valordocumento; data += "&" + "numeroparcela" + "=" + numeroparcela; data += "&" + "totalparcelas" + "=" + totalparcelas; data += "&" + "numerodocumento" + "=" + numerodocumento; data += "&" + "L1" + "=" + L1; data += "&" + "L2" + "=" + L2; data += "&" + "L3" + "=" + L3; data += "&" + "L4" + "=" + L4; data += "&" + "L5" + "=" + L5; data += "&" + "unidadecedente" + "=" + unidadecedente; data += "&" + "numerodocumento" + "=" + numerodocumento; data += "&" + "nomesacado" + "=" + nomesacado; data += "&" + "cpfcnpjsacado" + "=" + cpfcnpjsacado; data += "&" + "enderecosacado" + "=" + enderecosacado; data += "&" + "numerosacado" + "=" + numerosacado; Copyright HSBC Bank Brazil SA - Banco Múltiplo - All rights reserved PUBLIC - 18

19 data += "&" + "complementosacado" + "=" + complementosacado; data += "&" + "cepsacado" + "=" + cepsacado; data += "&" + "bairrosacado" + "=" + bairrosacado; data += "&" + "cidadesacado" + "=" + cidadesacado; data += "&" + "estadosacado" + "=" + estadosacado; Encoding encoding = EncodingASCII; byte[] dados = encodinggetbytes(data); // Prepara chamada HttpWebRequest orequest = (HttpWebRequest)WebRequestCreate(url); orequestmethod = "POST"; orequestcontenttype = "application/x-www-form-urlencoded"; orequestcontentlength = dadoslength; Stream oreqstream = orequestgetrequeststream(); //Envia os dados oreqstreamwrite(dados, 0, dadoslength); oreqstreamclose(); //Recupera resposta HttpWebResponse oresponse = (HttpWebResponse)oRequestGetResponse(); Stream orespstream = oresponsegetresponsestream(); int buffer = 1024; byte[] databuffer = new byte[buffer]; int count = 0; MemoryStream ms = new MemoryStream(); while ((count = orespstreamread(databuffer, 0, buffer)) > 0) { mswrite(databuffer, 0, count); orespstreamclose(); ResponseAddHeader("Content-Type", "application/pdf"); //To open the file in browser, define the property below as "inline" //To force file download, define the property below as "attachment" //To define the file name, define the property filename below the desired name, // in this case it is defined as BoletoHSBCpdf but could be any file name that better // suits the customer needs //If you do not want to define a file name, just leave it blank or erase the property filename below ResponseAddHeader("Content-Disposition", "inline; filename=boletohsbcpdf;"); ResponseAddHeader("Content-Length", mslengthtostring()); ResponseBinaryWrite(msToArray()); ResponseFlush(); ResponseEnd(); Observation: The example above is for solution understanding to be developed and not for the use exactly as it is Copyright HSBC Bank Brazil SA - Banco Múltiplo - All rights reserved PUBLIC - 19

20 17 GLOSSARY Bloqueto: bar-coded bills that are issued by the seller to the buyer of goods or services which can be paid electronically, via Internet banking, ATM or at bank branches with cash, card or check Bloquetos contain all relevant invoice information and may be issued electronically or in a paper-based format and delivered via the postal service or private couriers CPF: Cadastro de Pessoa Física Tax Roll of Natural Person CNPJ: Cadastro Nacional de Pessoa Jurídica National Directoru of Legal Entities Copyright HSBC Bank Brazil SA - Banco Múltiplo - All rights reserved PUBLIC - 20