Skip to main content
A product with subscriptions turned on and a billing period can be bought as a subscription. When the customer pays with PapelPay, the card is charged again every period until they cancel. With any other payment method, the customer gets a renewal invoice by email before each period ends. This page shows how to control that choice from the Store API.

Choose subscription or one-time

Send auto_renew when you create the order:
auto_renew: true needs an order with exactly one product line, and that product must have subscriptions turned on with a billing period. Otherwise the call fails with SUBSCRIPTION_NOT_AVAILABLE (422) and no order is created.

The subscription object

Create and detail responses of an order include subscription. It is null when the order can’t be a subscription.

After payment

The first payment completes the order and starts the subscription. Each renewal creates a new paid order and extends the subscription. Read and stop subscriptions with these endpoints: Stopping an automatic renewal ends future charges at the end of the paid period. Cancelling never refunds the customer.
Subscription card payments are charged in USD.