Solutions in E-Commerce Technical Guidelines for the Contracting Company Version 015 10.03.2009
Summary I. Presentation Offered Advantages... 3 Requirements... 3 II. Payment Methods Debit Account via Internet... 4 BB Internet Credit... 4 Transaction slip... 4 III. Characteristics How it works... 5 Magnetic information exchange... 5 IV. Implantation Guide Agreement formalization... 6 Code development... 6 Simulations and approvals of the implementation... 6 Activation of the agreement... 6 V. Attachments 1. Flux of Payments... 7 2. Formalization... 8 Variables by using the forms... 8 a) Payment form Payment... 9 b) Return form... 10 c) Sonda form... 10 Response of the Sonda form... 11 XML Structure... 11 lojavirtual.dtd Structure... 11 Response in a String form... 11 e) Sales Cancelation form... 14 3. Layout of the return file debit account... 15 4. Document update history... 16 Version 015 TECHNICAL SUPPORT: 0800-729-0500 2
I. Introduction This manual provides the necessary information for the correct integration of the virtual store with Banco do Brasil s payment environment and gives some basic clarifying information about BB electronic commerce and how it is operated. It considers variables to allow the management of the points in the Relationship Program of Banco do Brasil with partners. The Electronic Commerce Solutions perform financial intermediation amongst companies and consumers (B2C) and amongst companies and companies (B2B), by offering a number payment options enabling the company to choose the most appropriate to their necessities. This is a secure and complete service, which allows the follow-up of transactions in real time within the Account Debit via Internet and BB Internet Credit, in the back-office of the company, using the Financial Manager or their own management system. Offered Advantages Requirements Simplicity in the implementation; All financial clearing on behalf of Banco do Brasil; Banco do Brasil s reliability and security; Lower fees and rates within the market; The greatest Internet client base in Latin America. Must be a client of Banco do Brasil; Have an updated register; Join BB E-commerce regulation and formalize the agreements for the type of payment method chosen; Follow the guidelines of this manual for the technical implementation of the solution. Version 015 TECHNICAL SUPPORT: 0800-729-0500 3
II. Payment Methods Debit Account via Internet This is a Cash payment method by charging the debit through the buyer s current account (Natural Person B2C or Legal Person B2B) and credit to the company s current account. The corresponding credit of the purchase/service will be through the company s account in D+N, according to the float previously negotiated with the relationship agency, grouped in a single launch. The company will receive a RCB001 file with a demonstration of all payments, including the payments via BB Internet Credit, in case this option is used by buyers, as well as starting a check up transaction on the BB site to verify the payment status of the purchase or the service order. BB Internet Credit This is a term method payment, by granting financing for the buyer (Natural Person) and up front credit for the company s current account. The corresponding credit for the purchase or service will be effectuated in the company s account in D+N, according to the float previously negotiated with the relationship agency, grouped with the payments made via Internet Debit Account, in a single launch. The company will receive a RCB001 file with the demonstrations of payments, including the payments via Internet Account Debit, as well as, how to begin a check up transaction on the BB site, to verify the status of the purchase or service order. In case the buyer wishes to cancel the purchase which has been already paid by this method, the company must fill out the specific form and forward it to the agency which holds the E-commerce agreement. This form is available in item V. Attachments - 2.e. Important: to contract the BB Internet Credit payment method, the company must also contract the Debit account method via Internet. Bank Transaction Slip - Collection without registration This form of payment generates a bank selling note printed by the buyer (Collection without registration). The corresponding credit for the purchase/service will be effectuated to the company s account in D+N, according to the float previously negotiated with the agency s relationship section, when the transaction slip has been settled. The company will receive a CBR643 or CNAB240 file with the demonstration of all payments. Version 015 TECHNICAL SUPPORT: 0800-729-0500 4
III. Characteristics How it works Starting from the site s store, the computer (Natural Person or Legal Person) chooses the type of payment. At this instance the allowable payment methods are presented for the agreement contracted with the Bank (in case there is only one payment method contracted with the Bank, only this one will be presented). When the Bank s site shows up, a passage of parameters occur which identify the source and which forms of payment must be offered for the transaction which are being executed. The validation of the agreement is performed in the Bank s environment. The entire process of client s authentication is involved in the transaction and verification of available funds (for payment methods that require such validation) as well as the processing of financial operations are conducted in a safe environment, ensuring data integrity throughout the flow of the transaction. The update of the database occurs in real time, allowing on-line status check up of the payment (check up only available for payments via Internet Debit Account or BB Internet Credit). The Bank offers all the information related to the financial transactions performed in the clients company through the Financial Management or the clients own management system. On-line Information Exchange The data bank update, relating to the effective payments, is processed in real time, allowing on-line payment status check up for the Debit account method via internet and BB Internet Credit (recovery of the transaction slip only through file, the following day). See information concerning the Sonda forms, Return and Informa, starting from page 9. Magnetic Information Exchange In addition to the on-line information, the Bank provides daily information of all payments executed through various methods, especially through the Financial Manager, enabling to check all payments made the previous day through the generation of file-return. Therefore when the agreement has been formalized, the company must choose one of the files exchange methods offered by the Bank. The files are: Debit Account via Internet and BB Internet Credit: file RCB001; Selling note: Files CBR643 or CNAB240. Version 015 TECHNICAL SUPPORT: 0800-729-0500 5
IV. Implantation Guide Formalization of agreements The following must be formalized in the company s relationship agency: Agreement of Collection, to allow payment via internet Debit Account; Agreement of Collection and the agreement of BB Internet Credit, to allow the payment via BB Internet Credit; Selling Note Agreement to allow the payment through a transaction slip; E-commerce agreement to allow the electronic exchange of parameters/information of the forms. The following attributes should be informed to the Bank: The client s Site (URL) for Return and for Information (see detailed information of the variables urlretorno and urlinforma, starting from page 9); E-mail of the person in charge of the development/maintenance of the solution; Buying value limit: maximum value allowed for each transaction. Important: Ask your manager for the Client s Initial Guideline document, which has the complementary orientations regarding the agreement and its use in the solution (numbers of the e-commerce agreements and selling note). The E-commerce agreement will have a status 9 Not Active. This situation allows the company to accomplish the development and the approval of the solution on their site. Development of the code The company must develop on the site s environment, a code of the Payment Form structure to capture the variables related to the payment. The code structure of the forms must also be implemented on the site s administration environment, which will allow on-line check up of the payment situation: - Return (URL Retorno); - Inform (URL Informa); - Sonda. The company responsible for the implementation must meet the following technical requirement: The Bank s link should only be activated after the buyer has executed all the necessary steps for the purchase (checkout), remaining only for the payment to be made; The page which receives the posting of the form can not be opened in frame. Example: the page can not have the tag html <frameset>. Verify the implementation details in the attachments of this document, starting form page 9. Simulations and approval of the implementation The company s technical team should perform payment simulations, in a way to guarantee the perfect functioning of the solution. The approval is performed in the production environment. While the situation for the agreement is 9 Not Active the payments performed by the option Debit through Internet Account will not affect the accounts involved. The Bank s system will allow the part processing of the flux, indicating that this operation is a simulation, without any accounting effect. In this situation the word Test will be shown next to the name of the company. Activation of the agreement After the completion of the approval phase, the company should notify their relationship agency that they are able to execute E-commerce Solutions on their site. Version 015 TECHNICAL SUPPORT: 0800-729-0500 6
With this information the agreement will be activated. Please note that only after the agency confirms that the agreement has been activated the company may execute the Electronic Commerce Solutions on their site. After the activation of the agreement the word Test will no longer be shown. Important: a variable reftran should be sequential, it does not allow to reutilizing numbers used in the tests. Version 015 TECHNICAL SUPPORT: 0800-729-0500 7
V. Attachments 1. FLUX OF PAYMENTS 1. The computer (Natural Person and/or Legal Person), after completing all the purchase phases, will request a checkout of the order on the contracting party s site; 2. The purchase order is calculated and registered and the attributions of the purchase order are presented to the consumer on the contracting party s site; 3. Variables of the payment form are put together on the contracting party s site; Obs: Verify item Forms Payment, for more details. 4. The purchase order is presented by the buyer for confirmation; 5. The buyer confirms the order and the seller s site submits a Payment form on BB site; 6. The Payment form and the agreement are validated on the BB site and is checked whether the requested value is less or the same as the value prearranged on the agreement; 7. The agreement s attributes are recovered by the Bank s site (invented name of the agreement, urlretorno of the contracting party s site, urlretorno, urlinforma the contracting party s site and the types of agreements which the company has with the Bank); 8. The BB site presents a page with the payment details. In case the type of payment has been chosen in item 5, the screen will show only the type of payment selected. On the contrary, there will be banners shown with the options for the transaction slip, Account Debit via Internet(natural person and legal person) and BB Internet Credit (according to the payment methods agreed by the company); 9. As an example, the computer selects payment by Account Debit in an account via Internet Natural Person; 10. The buyer informs his data, account and internet password to the agency and is authenticated by the Bank; 11. The buyer informs the final password to confirm the payment; 12. The BB site presents and a page informing electronic authentication of the payment (the client must print this page, which is their proof of payment). At this instance, the informa form is activated (more information on page 10), even when problems with payment occur (system error, lack of funds, lack of credit limit, etc). In case the computer is clicked on the Return to Store button, available on this page, the Return form will be activated (more information on page 10), which directs the client once again to the contracting party s site; OBS: The Informa form is available only for purchases performed by a Natural Person. 13. The server, the site or the application of the contracting party may add the Sonda form (more information on page 10), in case it is necessary to know the immediate situation of each payment, at the same moment when it receives the posted data by the informa form or Return (mentioned above), or at the moment after the finalization of the transaction. This form can only be used for payments via Internet Debit Account or BB Internet Credit and exchange of points through the Bank s relationship Program. 14. The BB site returns the answer to the Sonda form; 15. BB makes available file(s) return(s) the following day after the liquidation of its commitments, according to the methods of payment, related to the payments made; Version 015 TECHNICAL SUPPORT: 0800-729-0500 8
2. FORMS Variables used in the forms For the operation of the E-commerce Solutions, variables are used which are shown below and should be used as indicated in each type of form. Variables Size Type Description Zip Code 8 Num Buyers Zip Code, without the hiphen which will be shown on the selling note City 18 Alfa Buyers city, which will be shown on the selling note Date of Payment 8 Num Date of payment accounting launch, in DDMMAAAA format dtvenc 8 Num Due date of payment, in DDMMAAAA format. OBS: future date is accepted only after the emission of the transaction slip. Address 60 Alfa Buyers address, which will be shown on the transaction note selling note format 2 Num The format of the return forms for consultation submitted to the bank: 01 HTML (Visual return in page of the Bank for manual control) 02 XML (Return in tag XML) 03 String (Return in String form) idconv 6 Num Code of the E-commerce agreement supplied by the Bank Information 3 Num Shows the payment transaction situation 000 transaction concluded NNN transaction not concluded, where NNN is a different number from 000 Important: sending the variable with code 000 does not guarantee the payment. The Sonda form must be effectuated for confirmation. Msgloja 480 Alfa Instructions from the vender will presented on the charging transaction slip Name 60 Alfa Name of the buyer, which will be presented on the selling note reftran 17 Num Assigned number generated and controlled by the contracting party, which identifies the purchase order in all the payment process. Each new transaction should generate another reftran number, not being able to be reused, especially the numbers used in the tests. In case a selling note is bound to the E-commerce agreement, request the number of this agreement for their agency and verify: a) for the selling note with 6 (six) positions the 17 positions are free; b) for the selling note with 7 (seven) positions inform: CCCCCCCNNNNNNNNNN, where: CCCCCCC = number of the selling note NNNNNNNNNN = free positions In case there is no selling note bound to the E-Commerce agreement, the 17 positions are free. Situation 2 Num tppagamento 1 or 2 Num For the Points Relationship Program, a variable is composed in the following way: CCCCCCCCCPPPPPPPP, where: CCCCCCCCC: The Relationship Program assumes: 999999901 The Client Relationship Program indicates 999999902 Legal Person Relationship Program PPPPPPPP Partner order Number Shows the situation of the payment: 00 payment done 01 payment not authorized 02 error in the consulting process 03 payment not found 10 idconv Field invalid or zero 11 value mentioned is invalid, zero or does not match the registered value registered 99 Operation canceled by the client According to the type of payment: 0 All types employed by the contracting party 2 Bank transaction slip 21 2nd issue of the transaction slip, previously generated 3 Debit in an Internet Account 5 BB Internet Credit For the Points Relationship Program, a variable is composed in the following method: 61 Type of payment with points of the Client s Relationship Program, shows Version 015 TECHNICAL SUPPORT: 0800-729-0500 9
the Client 62 Type of payment with points of the Leal Person Relationship Program Uf 2 Alfa The buyer s situation will be presented in the selling note Completion of the address (URL) will be activated, showing that a transaction was finalized on the BB site, being up to the contracting party to activate the Sonda Form to confirm the financial liquidation of the purchase The activated address (URL) is composed by the concatenation of two parts: - one part registered in the agency. Example: https://www.teste.com.br urlinforma - one part will be the complement of the fixed part that will be informed in 60 Alfa this variable (urlinforma). Example: /InformaBB.asp?1358568 In this case, the following address will be activated: https://www.teste.com.br/informabb.asp?1358568 Important: The activation of the Informa form does not mean, no matter what, the liquidation of the financial commitment. The contracting party must activate the Sonda form to confirm or wait for the availability of the file return the following working day after the payment has been done. (URL) address where the client will be directed to, through a Return form, in case it wishes to return identified to the contracting party s site, beginning from the last page of the payment process, clicking on the available button on this page. Composed by the concatenation of the two parties: - one part registered at the agency. Example: https://www.teste.com.br - one part will be the complement of the registered part at the agency urlreturn 60 Alfa informed in this variable (urlretorno). Example: /RetornoBB.asp?1358568 In this example, the client will be directed to the following site: https://www.teste.com.br/retornobb.asp?1358568 Important: The sending of the Return form to the specified site does not mean in any way the liquidation of the financial commitment. The contracting party must activate the Sonda form confirm the transaction or wait for the availability of the return file the next following working day after the payment has been done. Total value of the purchase in Reais, with cents with no formatting. Example: for R$ 195,72 write 19572 Value 15 Num qtdpontos 15 Num valuesonda 15 Num For the Points Relationship Program, a variable is composed in the following way: Value in reais transaction, inform zero s Exclusive value for the Points Relationship Program. The number of points to be received in the Relationship Program. Total value of the purchase in Reais, with cents without formatting. Example: for R$ 195,72 write 19572 a) Payment Form Variables in the sending of the Payment form: The Contracting party site The Bank s site Variable idconv reftran valor qtdpontos dtvenc tppagamento urlretorno urlinforma name Address City State Zip code msgstore Utilization (for the Points Relationship Program inform zeros) (exclusive variable for the Points Relationship Points) Optional when transaction slip is allowed when transaction slip is allowed when transaction slip is allowed when transaction slip is allowed optional Version 015 TECHNICAL SUPPORT: 0800-729-0500 10
OBS: For the generation of the 2nd issue of the selling note, a variable tppayment will be filled out with 21 and all the fields must be identical as the 1st issue of the selling note. In case there is a need to alter the fields, it is necessary to request the generation of the transaction slip with a new reftran and with the tppayment represented by 2. Structure of the Payment form <form action="https://www16.bancodobrasil.com.br/site/mpag/" method="post" name="pagamento"> <input type="hidden" name="idconv" value="<%= idconv %>"> <input type="hidden" name="reftran" value="<%= reftran %>"> <input type="hidden" name="valor" value="<%= valor %>"> <input type="hidden" name="qtdpontos" value="<%= qtdpoints %>"> <input type="hidden" name="dtvenc" value="<%= dtvenc %>"> <input type="hidden" name="tppagamento value= "<%= tppayment %>"> <input type="hidden" name="urlretorno" value="<%= urlreturn %>"> <input type="hidden" name="urlinforma" value="<%= urlinforma %>"> <input type="hidden" name="nome" value="<%= name %>"> <input type="hidden" name="endereço" value="<%= address %>"> <input type="hidden" name="cidade" value="<%= cidade %>"> <input type="hidden" name="uf" value="<%= uf %>"> <input type="hidden" name="cep" value="<%= cep %>"> <input type="hidden" name="msgloja" value="<%= msglojae %>"> </form> b) Return Form Variables in the sending of the Return form: The Bank s site the contracting party s site. This form is added by the Banco do Brasil site, if the buyer after completing a payment, clicks on the return to Store button. It allows the contracting party to identify which client is returning to their site after completing the payment transaction or the issuing of the transaction slip on the BB site. It does not represent the liquidation of the financial commitment, which should be confirmed through the Sonda form (as shown in item d below). Variable reftran idconv tppagamento Utilization Structure of the Return form <form action="return form of the contracting party registered at the Bank+complement*" method="post" name="return"> <!-- Return of variables for the Store --> <input type="hidden" name="reftran" value=""> <input type="hidden" name="idconv" value=""> <input type="hidden" name="tppayment" value=""> </form> (*) complement is the content of the variable urlreturn obtained in the payment form c) Informa Flux Form (For a Natural Person s current account transaction) Obs: The fixed part (registered at the Bank) of the URL address Informa should be the same URL Return. 1) The Payment form should contain an urlinforma variable Version 015 TECHNICAL SUPPORT: 0800-729-0500 11
2) When the proof of payment is presented, the Informa form is activated, with the following structure: Example data: E-commerce agreement number = 8308 Reference of the transaction = 52170785 Value of the transaction = R$ 2.567,89 Example 1 (concatenation without character "?") A fixed part registers at the Bank: http://www.loja.com.br urlinforma variable content: /teste.jsp the BB activates the address: http://www.loja.com.br/teste.jsp?reftran=52170785&idconv=8308&valor=256789 Example 2 (concatenation with character "?"): Fixed part registered at the Bank: http://www.loja.com.br urlinforma Informa variable: /teste.jsp?parametrodaloja=seila BB activates the address: http://www.loja.com.br/teste.jsp?parametrodaloja=seila&reftran=52170785&idconv=8308&val or=256789 That is, if the concatenation of the urlinforma registered with BB urlinforma sent in the payment form does not have the character "?", the bank will include at the end of the concatenation the character "?" and information? reftran = 52170785 & idconv = 8308 & value = 256789 In case the character "?" exists in this concatenation, the bank will include the character "&" at the end of this concatenation and the information &reftran=52170785&idconv=8308&valor=256789 For the Points Relationship Program: Variables of the Inform sending file: The Bank s site The Contracting party s site This form is used by the BB to send the partner the information that an exchange transaction has occurred. With this information the partner activates the Sonda form to search for the transaction confirmation at BB. Variable idconv reftran value qtdpoints Utilization (inform zeros) d) Sonda Form ( on-line consultation regarding the payment situation) Variables in the sending of the Sonda form: The contracting party s site The Bank s site Observation: on-line consultation available of payments done by Debit account via the Internet or BB Internet Credit. Variable idconv reftran valuesonda qtdpontos format Utilization (for the Points Relationship Program inform the zero s) (exclusive for the Relationship Points Program) Version 015 TECHNICAL SUPPORT: 0800-729-0500 12
Structure of the Sonda form <form action=" https://www16.bb.com.br/site/mpag/rec3.jsp" method="post" name="sonda"> <input type="hidden" name="idconv" value="<%= idconv %>"> <input type="hidden" name="reftran" value="<%= reftran %>"> <input type="hidden" name="qtdpontos" value="<%= qtdpontos %>"> <input type="hidden" name="valsonda" value="<%= valor %>"> <input type="hidden" name="formato" value="<%= formato %>"> </form> Response from the Sonda form Variables in sending the response of the Sonda form: The Bank s site the contracting party s site Variable reftran valor idconv tppagamento situacao datapagamento qtdpontos Utilization Conditional (exclusively for the Points Relationship Program) XML Structure <?xml version='1.0' encoding='iso-8859-1' standalone='no'?> <!DOCTYPE lojavirtual SYSTEM "lojavirtual.dtd"> <FORMULARIO> <ENTRADA nome="reftran" valor=""/> <ENTRADA nome="valor" valor=""/> <ENTRADA nome="idconv" valor=""/> <ENTRADA nome="tppagamento" valor=""/> <ENTRADA nome="situacao" valor=""/> <ENTRADA nome="datapagamento" valor=""/> <ENTRADA nome="qtdpontos" valor=""/> </FORMULARIO> Structure of the lojavirtual.dtd <?xml version="1.0" encoding="iso-8859-1"?> <!ELEMENT FORMULARIO (ENTRADA)+> <!ELEMENT ENTRADA (EMPTY)> <!ATTLIST ENTRADA nome CDATA #REQUIRED valor CDATA #REQUIRED> Response in a String form String = aaaaaaaaaaaaaaaaa000000000000000bbbbbbcddeeeeeeeeqqqqqqqqqqqqqqq Where and is a Variable aaaaaaaaaaaaaaaaa reftran 000000000000000 Value bbbbbb idconv c tppagmento dd Situation eeeeeeee datapagamento qqqqqqqqqqqqqqq qtdpontos (exclusive for the Points Relationship Program) Version 015 TECHNICAL SUPPORT: 0800-729-0500 13
e) Sales Cancelation Form Place and date To Banco do Brasil S.A. Agency (Name of Agency) Dear Manager, SALES CANCELATION According to the regulation of Banco do Brasil s Electronic Commerce, seventh Clause, point i, cancelation communication, as below: idconv Code Sales date Sales value Order number reftran (id.banco/id.loja) Code 2. I(we) authorize this Bank to chargeback our current account the value above. Company s Signature ---------------------------------------------------------------------- Version 015 TECHNICAL SUPPORT: 0800-729-0500 14
3. LAYOUT OF THE RETURN FILE INTERNET DEBIT ACCOUNT HEADER OF THE RETURN FILE REGISTRATION CODE A Field Position Type Content A1 01-01 Alfa (001) Register code of assumes A A2 02-02 Num (001) Remittance code of assumes 2 (return sent by the Bank) A3 03-08 Num (006) Agreement number A4 09-09 Alfa (001) Future use A5 10-18 Num (009) Num Return of the Electronic Exchange data sequential A6 19-22 Alfa (005) Future use A7 23-42 Alfa (020) Name of company / institution A8 43-45 Num (003) Num Bank code of the banking compensation A9 46-65 Alfa (020) Name of bank A10 66-73 Num (008) Date of the file generation AAAAMMDD - format A11 74-79 Num (006) File sequential number A12 80-81 Num (002) FEBRABAN layout version adopted for registration type G A13 82-142 Alfa (061) Reserved for future use A14 143-150 Alfa (008) In case of E-commerce this space will be empty RETURN FILE DETAIL REGISTRATION CODE G Field Position Type Content G1 01-01 Alfa (001) Register code assumes G G2 02-05 Num (004) Agency prefix number of credit G3 06-06 Alfa (001) Verifying digit of the agency module 11 G4 07-15 Num (009) Current account number of credit G5 16-16 Alfa (001) Verifying digit number of current account-module 11 G6 17-21 Alfa (005) Future use G7 22-29 Num (008) Payment date AAAAMMDD format G8 30-37 Num (008) Date of credit AAAAMMDD format G9 38-81 Alfa (044) Bar code see specifications below G10 82-93 Num (010)v99 Received value G11 94-100 Num (005)v99 Fee value G12 101-108 Num (008) Register sequential number G13 109-112 Num (004) Prefix of the receiving agency G14 113-116 Alfa (004) Future use G15 117-117 Num (001) Method of collection 1- Cash desk, 2 - Electronic, 3 - Internet G16 118-140 Alfa (023) Electronic authentication G17 141-141 Num (001) Receiving method: 1- Money, 2 - Check, 3 Not identified G18 142-150 Alfa (009) Future use FIELD G9 BAR CODE Field Position Type Content G9.1 01-01 Num (001) Code indentifying number of the product - assume 8 (collection) G9.2 02-02 Num (001) Sequential identification and company/institution identification method assume: 9 G9.3 03-03 Num (001) Real value or reference identifier assumes 6 (real) G9.4 04-04 Num (001) General verifying digit modulo 10 G9.5 05-15 Num (011) Value in reais G9.6 16-19 Num (004) BB code at clearance. Assumes: 0001 G9.7 20-21 Num (002) Filled out with value 01. G9.8 22-27 Num (006) Agreement code RCB G9.9 28-44 Num (017) Order number (and the value which was assigned to the variable reftran generated by the contracting party) RETURN FILE TRAILER REGISTRATION CODE Z Field Position Type Content Z1 01-01 X(001) Register code assume Z Z2 02-07 9(006) Total of file registers, inclusive header and trailer Z3 08-24 9(017) Total value received from the free file Z4 25-150 X(126) free Version 015 TECHNICAL SUPPORT: 0800-729-0500 15
4. UPDATES HISTORY OF THIS DOCUMENT Updating number: 015 Date of publication: 10.03.2009 Reason for update: Contemplates an inclusion of variables of the dealing with points in the Relationship Program at Banco do Brasil Update number: 014.3 Date of publication: 09.04.2008 Reason for update: Inclusion of the Sales Cancelation Form. Update number: 014.2 Date of publication: 23.10.2007 Reason for update: Inclusion of the variable urlinforma, available for Natural Person. Update number: 014.1 Date of publication: 21.07.2006 Reason for update: Inclusion of the variable urlinforma and the revision of the entire manual. Update number: 013 Date of publication: 28.06.2006 Reason for update: Posting address altered and the exclusion of form variables. Update number: 012 Date of publication: 26.05.2006 Reason for update: Inclusion of the payment option via BB Internet Credit Update number: 011 Date of publication: 22.03.2006 Reason for update: Text of the variable description altered "reftran" and other editing adjustments Update number: 010 Date of publication: 09.07.2004 Reason for update: Editing Adjustments. Update number: 009 Date of publication: 14.06.2004 Reason for update: Text of the variable description altered "reftran" and other editing adjustments. Update number: 008 Date of publication: 27.02.2003 Reason for update: Correction on page 19, detail in field G9 Bar Codes Update number: 007 Date of publication: 29.11.2002 Reason for update: - Inclusion of the configuration of the 2 nd issuing of the selling note Update number: 006 Date of publication: 13.11.2002 Reason for update: Alteration of the reftran from 12 positions to 17 positions in the www11 server Update number: 005 Date of publication: 13.05.2002 Reason for update: Alteration of the Guide s name and inclusion of the technical support telephone number Update number: 004 Date of publication: 13.12.2001 Reason for update: Alteration of the address to where the payment form should be sent from Sonda. Inclusion of the debit account for Legal Person, and new format of the return of the sonda. Update number: 003 Date of publication: 09.04.2001 Reason for update: Permits that the size of the variable reftran is in 17 positions, when the payment option is through a transaction slip (tppagamento = 2). Only available for transactions which point to the www10 server. Update number: 002 Date of publication: 12.03.2001 Reason for update: Return of the sonda checks the payment situation, in XML format. Alteration of the url systematic set up of the return page to the contracting party s site. Alteration of the selling slip layout. Update number: 001 Date of publication: 15.12.2000 Reason for update: Alteration of the URL for posting the payment form and checking the payment. Version 015 TECHNICAL SUPPORT: 0800-729-0500 16
GLOSSARY Informa - Informs Sonda Pagamento - payment Pontos - points Valor - value Entrada - entry Nome - name Loja virtual virtual store Cep zip code Uf - state Cidade - city Dt.venc. - due date Version 015 TECHNICAL SUPPORT: 0800-729-0500 17