Pix Automatico

Pix Automatico extends Brazil's instant-payment system Pix to support auto-renewing subscriptions. Subscriptions are charged automatically against a recurring authorization the buyer approves in their bank's Pix app at the time of the initial purchase.

Pix Automatico is available only in Brazil using BRL. It is offered alongside one-time Pix as a localized payment option for sellers who want to offer recurring billing to Brazilian buyers.

The sections below explain the prerequisites, buyer flow, and technical details for Pix Automatico. Select a section or use the TOC on the right to jump ahead.

Prerequisites

To use Pix Automatico, the following requirements must be met:

• The buyer must be in Brazil and the store currency must be set to BRL.
• Pix Automatico must be enabled on your store. Contact FastSpring Support to request enablement.
• The product must be configured as an auto-renewing subscription. Weekly billing periods are not supported.
• The buyer must have a bank account with a Brazilian institution that supports Pix Automatico, and must approve the recurring authorization in their bank's Pix app at checkout.

Customer experience

Pix Automatico is an asynchronous payment method. The initial setup completes quickly, but renewals take longer to settle and follow strict timing rules set by the Brazilian banking system.

Initial purchase and authorization setup

1. The buyer selects Pix as their payment method on a subscription product.
2. FastSpring displays a Pix QR code or copy-and-paste key.
3. The buyer authorizes the recurring Pix agreement in their bank's Pix app, granting permission for FastSpring to debit future renewals automatically.
4. The first charge is processed and confirmed.
5. The FastSpring checkout updates to show success once the buyer's bank confirms the payment.

Banking regulations

Pix Automatico is governed by recurring-payment rules set by the Banco Central do Brasil (BCB) and operated through the Pix network. The constraints below come directly from those rules and are not configurable per seller.

• No proration. Pix Automatico does not support prorated subscription edits. Off-cycle (proration) charges are not permitted.
• Maximum 3 charge attempts in any 7-day window. This applies across both initial charges and dunning retries.
• Pre-charge edit window. Once a charge is queued, no edits can be made for 72 hours before the scheduled charge date.
• Post-charge edit window. After a successful charge, the subscription is in a 7-day window during which subscription edits are blocked.

Transaction limits

Subscription edits and proration

Subscription edits are only permitted in the window between the post-charge and pre-charge edit periods.

Standard subscriptions

For a typical 30-day subscription, the editable window is roughly Day 7 through Day 27 of each cycle.

Managed subscriptions

While the subscription is in a blocked window, the Edit button is disabled in the FastSpring app and the API returns a structured error (see API reference).

Dunning

Pix Automatico uses a dedicated dunning schedule that is independent of your store's standard card-and-PayPal dunning configuration.

Schedule rules

• Recurring Pix must be enabled at the store level.
• Up to 3 retry attempts.
• Each attempt is configured as a number of days after the last payment (for example, 2 / 2 / 2 days).
• The total dunning window cannot exceed 7 days.

Notifications and cancellation

• Overdue notifications configured for the store fire on Pix Automatico subscriptions before deactivation. For example, if you have 4 overdue notifications set every 3 days, all 4 notifications send before the subscription is deactivated.
• If a buyer updates their payment method during dunning — to a re-authorized Pix agreement or any other supported payment method — FastSpring uses the new method to immediately initiate the charge, ending the dunning sequence.

After dunning ends

If all retries are exhausted within the 7-day window, the subscription is deactivated per your dunning configuration. Buyers can revive the subscription anytime by visiting their Account Management page and updating their payment method.

Refunds and disputes

Refunds for Pix Automatico can be initiated by sellers or by FastSpring Support from within the FastSpring app.

• Full and partial refunds are supported for completed Pix Automatico charges.
• Offline refunds are supported.
• FastSpring automatically checks payment status before issuing a refund.
• Buyers typically receive a refund within 1–3 business days to the bank account associated with the original Pix authorization.
• Disputes are routed through the standard Pix dispute workflow.

API reference

Pix Automatico uses the same subscription endpoints as other FastSpring payment methods. The differences are limited to edit-window enforcement and the errors returned when a request is rejected. Most notably, any request that asks for proration on a Pix subscription is rejected.

Endpoints

Proration handling

Subscription update requests with prorate=true are always rejected for Pix Automatico subscriptions. The system does not silently downgrade to a non-prorated edit. Always send prorate=false for Pix subscriptions, or branch on payment method when constructing the request.

Examples

Initiate a managed-subscription charge

POST /subscriptions/charge

{
  "subscriptions": [
    { "subscription": "dQp8vBnZ7tRcMkXy3wHj1G" }
  ]
}

Update a subscription without proration

POST /subscriptions

{
  "subscriptions": [
    {
      "subscription": "nFc4hWqL5yPbRtZx9mKj2D",
      "quantity": 2,
      "prorate": false
    }
  ]
}

Update a subscription with proration

POST /subscriptions

{
  "subscriptions": [
    {
      "subscription": "nFc4hWqL5yPbRtZx9mKj2D",
      "quantity": 2,
      "prorate": true
    }
  ]
}

Webhooks

FastSpring includes the following details in the order.completed webhook payload for Pix Automatico transactions:

"payment": {
  "type": "pix"
}

The standard subscription lifecycle webhooks also fire for Pix Automatico:

• subscription.charge.completed — fires when a Pix Automatico rebill settles successfully (typically within 48 hours of the request).
• subscription.charge.failed — fires when the buyer's bank declines the charge or the recurring authorization has been revoked.
• subscription.payment.overdue — fires when a renewal enters dunning. Dunning runs for up to 7 days with up to 3 retry attempts, after which the subscription is deactivated per your dunning configuration.

For details on the order.completed payload, see the Successful Orders documentation.

FAQs