...
Request parameters (see notes below):
5.1. Sending a payout
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 |
action | Action to be performed. Value "addpayout". | Yes | 9 |
payee_id | CPF/CNPJ of the recipient of the payout amount (payee_taxid submitted on "addpayee" action). When transferring between PagBrasil merchant accounts, please use the pbtoken assigned to the recipient's account. | Yes | 32 |
payout_amount | Amount to be paid to recipient in Brazilian Real. Format: 99999.99 | Yes |
7.2 | |||
payout_description | Description to be saved as the product name preceded by "Payout - " (e.g. considering payout_description = "XYZ", product name is set as "Payout - XYZ"). When not informed, product name is simply set as "Payout". | No | 254 |
payout_date |
When a payout is successfully registered in our database, PagBrasil's response has the following structure:
Field | Description | Length |
|---|---|---|
action | Value "addpayout". | 9 |
success | Value "true" indicates the payout was successfully included in our database. | 5 |
id | Unique number that identifies the payout. | Unlimited |
When a payout failed to be registered in our database, PagBrasil's response has the following structure:
Field | Description | Length |
|---|---|---|
action | Value "addpayout". | 9 |
success | Value "false" indicates the payout failed to be included in our database. | 5 |
error_message | Error message(s), separated by semicolons. | Unlimited |
internal_message | PagBrasil's internal use information. | Unlimited |
5.2. Receiving the webhook
PagBrasil will send a webhook to your server whenever a payout is requested or processed (except when transferring between PagBrasil merchant accounts). See note "g"
...
Webhook content has the following structure:
Field | Description | Length |
|---|---|---|
secret | Secret phrase as defined in the PagBrasil Dashboard | 128 |
action | addpayout = Payout requested | 13 |
taxid | CPF/CNPJ of the recipient of the payout amount. | 14 |
id | Unique number that identifies the payout. | Unlimited |
amount | Payout amount in Brazilian Real |
7.2 | ||
date | Timestamp. Format: YYYY-MM-DD HH:MM:SS | 19 |
signature | HMAC-MD5 hash that authenticates the webhook. |
32 |
Notes:
a) All fields are required except when noted otherwise.
...
Example of javascript to prevent other characters than digits:
| Code Block | ||
|---|---|---|
| ||
onKeyPress='if (window.event.keyCode<48 || window.event.keyCode>57) event.returnValue = false;' |
...
Due to validation security reasons, this field cannot be changed after insertion. In order to change this information you must delete the old payee and then add a new one.
...
| Anchor | ||||
|---|---|---|---|---|
|
...
f) After processing our webhook, your server needs to acknowledge that it has successfully received it by writing "Received successfully [timestamp]". If the webhook fails our system will e-mail your technical contact a warning notification (subject "Urgent: Error posting webhook"). If you activate the auto resend, our system will then try to resend failed webhook as follows:
The next 7 attempts will take place every 7 minutes.
The next 23 attempts will take place every 60 minutes. If the last attempt of sending the webhook fails, our system will e-mail another warning notification (subject "Urgent: Error posting webhook").
Please note that any webhook can be resent manually at any time at the PagBrasil Dashboard.