...
Field | Description | Required | Length |
|---|
secret | Secret phrase as defined in the PagBrasil Dashboard | Yes | 128 |
pbtoken | Token assigned to your merchant account.
Your token is displayed at the PagBrasil Dashboard, menu Account > Settings. | Yes | 32 |
order | Order number | Yes | 64 |
amount_refunded | Amount requested to be refunded (Brazilian Real) | Yes | 57.2 |
customer_bank | Customer's bank number (número do banco). See note "e" | Yes | 3 |
customer_branch | Branch number (agência). | Yes | 12 |
customer_account | Account number (conta corrente). Must include the hyphen and the verification digit; for example: "12345678-0". | Yes | 12 |
...
Field | Description | Length |
|---|
secret | Secret phrase as defined in the PagBrasil Dashboard | 128 |
payment_method | Value "B". This value specifies that the data being posted is the response to a Boleto Bancário refund request (either for a traditional Boleto Bancário or a Boleto Flash®). | 1 |
order | Order number | 64 |
amount_brl | Amount in Brazilian Real | 57.2 |
amount_refunded | Amount requested to be refunded (Brazilian Real) | 57.2 |
payment_status | P = Refund Processed See note "a"
J = Refund rejected See note "b" | 1 |
signature | HMAC-MD5 hash that authenticates the IPN. See note "c" | 32 |
The payment status is returned as "P" (Refund Processed) when the refund request was submitted to the bank using the account information provided by the end customer. Please note that the Refund Processed status doesn't necessarily mean that the customer has received the credit, as the money can later be returned by the recipient's bank if the account information turns out to be incorrect.
...
b) The payment status is returned as "J" (Refund rejected) when the money has been returned by the recipient's bank because the account information provided was incorrect. In this case, please ask the customer to confirm that the bank details are correct and that they are the account holder. When you have their correct information you may request the refund again.
...
c) To authenticate the legitimacy of the IPN, you may check the parameter secret and/or the parameter signature, which is a HMAC-MD5 hash based on three parameters and a key defined at the PagBrasil Dashboard, menu Account > Settings. The HMAC-MD5 source string is the concatenation of the values of the parameters order, amount_brl and payment_status and the total length for these three parameters. For example, if parameter order="1234567890", amount_brl="39.50" and payment_status="P", the parameter signature would be "3093a7dffa0c04e74e827d1b52ef514e".
...