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

SourceBehaviorIdentification field
SubscriptionA new charge is created at each cyclesubscription
Payment linkA charge is created when the link is usedpaymentLink
Static Pix QR CodeA Pix charge is created after the payment is receivedpixQrCodeId
Received Pix transferA charge is created automaticallypixTransaction
Received TEDA charge is created automaticallyCharge 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:

  • billingType equal to PIX;
  • pixQrCodeId with 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.


Did this page help you?