How does Asaas handle revenue in the account?
At Asaas, the main source of revenue is charges.
Whenever an amount comes into the account, Asaas records the revenue in the statement and associates it with a charge.
Depending on the source of the receipt, this charge may be created automatically and contain fields that identify the related resource.
Monitor the Payments Webhook and use the returned fields to identify the source of each charge.
How to identify the source of the charge
| Source | Behavior | Identification field |
|---|---|---|
| Subscription | A new charge is created at each cycle | subscription |
| Payment link | A charge is created when the link is used | paymentLink |
| Static Pix QR Code | A Pix charge is created after the payment is received | pixQrCodeId |
| Received Pix transfer | A charge is created automatically | pixTransaction |
| Received TED | A charge is created automatically | Charge description |
Subscriptions
Subscriptions generate new charges according to the configured billing cycle.
For credit card charges, the payment may occur automatically. For other methods, such as bank slip (boleto), the charge is created for the customer to pay.
Charges originating from a subscription include the subscription field with the corresponding ID.
Payment links
When a customer uses a payment link, a charge is created.
For credit card or Pix payments, the charge may be created already paid. For bank slips (boleto), it remains available for payment according to the link settings.
The paymentLink field contains the ID of the link that originated the charge.
Static Pix QR Code
When receiving a payment through a static Pix QR Code, Asaas creates a charge with:
billingTypeequal toPIX;pixQrCodeIdwith the ID of the QR Code used.
In the statement, the charge will be shown with the description:
Charge automatically created from a received Pix.
Received transfers
Transfers received via Pix or TED also create charges automatically.
Pix
The charge includes the pixTransaction field with the ID of the Pix transaction.
TED
The charge will be shown with the description:
Charge automatically generated from a received TED.
Recommendation for your integration
To identify the source of a revenue entry, check the fields of the charge received via Webhook.
Avoid relying only on the description shown in the statement, since the fields related to the resource provide a more structured identification.
Updated 17 days ago
