...
Field | Description | Length |
|---|
secret | Secret phrase as defined in the PagBrasil Dashboard | 128 |
payment_method | Value "X". This value specifies that the data being posted is the response to a PagBrasil Pix refund request. | 1 |
order | Order number | 64 |
amount_brl | Amount in Brazilian Real | 5.2 |
amount_refunded | Amount refunded (Brazilian Real) | 5.2 |
payment_status | C = Chargeback See note "a"
P = Refund Processed See note "b"
J = Refund rejected See note "c" | 1 |
signature | HMAC-MD5 hash that authenticates the IPN.
See note "d" | 32 |
Notes:
a) The payment status is returned as "C" (Chargeback) when a previously authorized transaction is reversed by the wallet/bank. In addition our system will send a chargeback notification to the e-mail address you registered at the PagBrasil Dashboard.
...
b) The payment status is returned as "P" (Refund Processed) when the refund request was accepted by the wallet/bank.
...
c) The payment status is returned as "J" (Refund rejected) when the refund request was not accepted by the wallet/bank. In this case our system will also send a notification to the email address you registered at the PagBrasil Dashboard, and you may refund the transaction through PagBrasil via bank transfer, by including the following parameters when requesting the refund via API: /div
...
IMPORTANT: The bank account holder must be the customer, and not a third-party. The fee for this type of refund is the same as that applied for a boleto bancário refund. Please refer to your proposal or contract for further details.
...
d) 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".
...