12. Document history
- PagBrasil
Date | Version | Change |
|---|---|---|
2024-02-06 | v831 | Removed the city of PORTO ALEGRE from the soft descriptor information. |
2022-05-24 | v830 | Changed the length of parameter order and cc_prevsaved to 64 characters. |
2022-03-28 | v820 | Added the possibility of re-submitting the same order number with different product_name and amount_brl (item 4.1). |
2020-10-05 | v810 | Added parameter cc_expiration to the "/api/order/get" response (item 5.2). |
2020-03-09 | v800 | The maximum period in which a credit card pre-authorization can be captured was increased from 4 to 14 days. |
2019-12-24 | v790 | Parameter cc_brand is no longer required when requesting a credit card authorization. Added new credit card error codes 18 and 19. Updated the expiration date of the test cards. |
2019-08-05 | v780 | Added the parameter customer_taxid as mandatory when deleting a previously saved credit card (item 7). |
2018-12-03 | v773 | Parameter customer_bank now expects the bank's number, and not the name. |
2018-10-18 | v772 | There is no more a specific format for product_name, but it remains mandatory. |
2018-10-17 | v771 | Included information that the content-type needs to be x-www-form-urlencoded. |
2018-10-03 | v770 | Added parameter wallet_type and wallet_payload for Samsung Pay transactions (item 4.1). Included information about the allowed ports in the IPN's URL (item 4.2). |
2018-07-12 | v761 | Changed the PagBrasil Dashboard tab name Update Information to Account. |
2018-06-11 | v760 | Added sample codes. Clarified item 4.1.l about the only parameters that should be submitted when capturing a previously authorized transaction. |
2018-02-26 | v750 | Added parameters cc_holder and cc_number to the "/api/order/get" response (item 5.2). |
2017-10-06 | v740 | Changed the endpoint URLs. Changed note 6.2.c explaining that now usually acquirers reject refunds older than 300 days, instead of 90. |
2017-06-13 | v733 | Included the information that it is the merchant that needs to ask the end customer for their bank details (item 6.2.c) when a refund via bank transfer is requested. |
2017-04-25 | v732 | Renamed "PagBrasil Merchant Interface" to "PagBrasil Dashboard". |
2017-02-28 | v731 | Clarified information about the soft descriptor (items 4.1.i and 4.1.o). |
2016-12-27 | v730 | Supressed the synchronous IPN if the credit card is able to be instantly processed (item 4.1.c). |
2016-10-21 | v722 | Changed the IPN expected response to "Received successfully [timestamp]" (item 4.2.a). |
2016-10-18 | v721 | Changed the length of parameter secret to 128 characters. |
2016-09-26 | v720 | Added parameter iframe_signature and iframe_custom (item 8). |
2016-07-22 | v710 | Changed the PagBrasil Merchant Interface and API's URLs to a sandbox subdomain. Changed the iframe's URL (item 8). |
2015-12-28 | v700 | Added parameter error_code to the IPN (item 4.2). Moved error codes table to item 9. |
2015-12-07 | v690 | Added pre-authorization and partial capture capability to Hipercards (item 4.1.l). |
2015-11-22 | v680 | Added the possibility to re-submit an order for any payment method if it was not already paid (item 4.1.d). Removed legacy Hipercards with 19 digits (item 4.1.n). |
2015-10-31 | v670 | Added parameter signature to the IPNs (item 4.2 and 6.2). Implemented a system that automatically resends failed IPNs (item 4.2.a) during a period of 24 hours. |
2015-09-28 | v660 | Changed the PagBrasil Merchant Interface and API's URLs. |
2015-09-16 | v650 | Added parameter "suspicious" to "refundorder" function (item 6.1). |
2015-09-01 | v640 | Removed the default parameters added to url_return when using the iframe (item 8). |
2015-08-22 | v630 | Changed parameter cc_descriptor to soft_descriptor, to unify names used in different functions. To preserve compatibility cc_descriptor is also accepted. |
2015-08-21 | v620 | Updated the information about the iframe's response (item 8.c). |
2015-08-20 | v610 | Added parameters customer_ip and visitor_id, required when using PagShield fraud prevention service (item 4.1). |
2015-08-17 | v600 | Changed the "addorder" response to an XML including the order details (item 4.1.c). Added authentication element "signature" to the "getorder" response (item 5.2.a). |
2015-06-08 | v550 | Added responsivity feature to the iframe (item 8). |
2015-04-08 | v540 | Added the possibility to re-submit a declined credit card order as a debit card (item 4.1.d). |
2015-01-31 | v530 | Added parameter form_target to the iframe (item 8). |
2014-10-28 | v520 | Added parameter iframe_style to the iframe (item 8). |
2014-10-23 | v510 | Added soft descriptor (parameter cc_descriptor) and dynamic parameters (param_url) capabilities to the iframe (item 8). |
2014-10-13 | v500 | Added the possibility of submitting bank details for credit card transactions that can't be refunded after 90 days (item 6.1). |
2014-09-23 | v490 | Added pre-authorization and partial capture features to the iframe (item 8). |
2014-09-08 | v480 | Added test cards for all credit card brands (item 4.1.o). |
2014-08-21 | v471 | Fixed Hipercard and Elo sample cards (item 4.1.n). |
2014-08-06 | v470 | Added pbtoken as a required parameter to be sent with the parameter secret to authenticate API requests. |
2014-06-29 | v461 | When using the iframe you may leave the parameter cc_installments blank, resulting in the iframe requesting the number of installments to the customer. When receiving the parameter cc_descriptor with invalid characters, we will accept it but remove those characters from the string. |
2014-06-17 | v460 | The soft descriptor (parameter cc_descriptor) is allowed to have spaces. Added regular expression to specify the characters allowed in the parameter order (item 4.1.d). |
2014-06-13 | v453 | Increased length of parameter cc_descriptor from 12 to 13. Corrected the length information of the parameter cc_installments. |
2014-06-06 | v452 | Changed example at item 8.a, step 5, to clarify the behaviour when parameter url_return contains a "?". |
2014-05-21 | v451 | Added note that "All fields are required except when noted otherwise". |
2014-03-28 | v450 | Added the possibility of displaying the iframe in Spanish. Added recurring payment feature to the iframe (item 8). |
2014-03-15 | v440 | Added parameter langiframe to define the language displayed on the iframe (item 8). |
2014-03-04 | v431 | Added note about credit card data storage restriction (item 4.1) |
2014-02-23 | v430 | Added notification via API when a refund is rejected (item 6.2.c). |
2014-01-13 | v421 | Changed payee information that needs to be displayed to customers to include the soft descriptor (item 4.1.o). |
2014-01-04 | v420 | Added parameter error_code for the payment failed reason (item 5.2.f). Added document history (item 10). |
2013-12-08 | v415 | Added an example of CPF and CNPJ (tax ID) for testing purposes. |
2013-12-02 | v414 | Changed PagBrasil identification on CC statements from "PAGBRASIL" to "PB" (item 4.1.o). |
2013-11-18 | v413 | Added the possibility of adding dynamic parameters when submitting an order (item 4.1.p) |
2013-10-22 | v403 | Added pre-authorization and partial capture features (item 4.1.l). |
2013-10-11 | v350 | Added notification via API when a refund is processed (item 4.2). |
2013-06-08 | v340 | Added support for Aura credit cards (item 4.1.m). |
2013-05-14 | v330 | Added chageback notifications via API (item 4.2). |
2013-05-08 | v322 | Added iframe to collect credit card details (item 8). |
2013-03-25 | v310 | Added recurring payment feature (items 4.1.j, 4.1.k and 7). |
2013-03-14 | v293 | Added new URLs for API calls (items 4.1, 5.1 and 6). |
2012-10-01 | v290 | Added the possibility of defining a default soft descriptor (item 4.1.i). |
2012-09-26 | v280 | Added the possibility to re-submit an order if it has been previously declined (item 4.1.d). |
2012-09-17 | v260 | Added soft descriptor capability (item 4.1.h). |
CONFIDENTIAL