Reviewed on 2026-09-19
Subscriptions and installments
A subscription creates cycles. An installment purchase remains one sale.
Run examples on your server with your own sandbox data. Never include keys in the frontend. This documentation does not enable live operations.
Automatic or manual
automatic_recurring requires an account and valid mandate. manual_renewal creates a new request the buyer pays each period. Wallets and transfers are not assumed to support automatic debit.
curl "https://payments.lunapay.ar/v1/subscriptions" \
-H "Authorization: Bearer $LUNAPAY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: sandbox-subscription-00001" \
-d '{
"customerId": "CUSTOMER_UUID",
"priceId": "RECURRING_PRICE_UUID",
"contractId": "CONTRACT_UUID",
"accountId": "ACCOUNT_UUID",
"mode": "automatic_recurring",
"termsVersion": "ACCEPTED_VERSION",
"consent": true
}'Trial and cancellation
Configure the trial on the recurring price. A free month ends on the same date next month, adjusted to the last valid day. Without a mandate, automatic charging is not promised. Mandate cancellation is asynchronous; check its status.
curl "https://payments.lunapay.ar/v1/subscriptions/SUBSCRIPTION_UUID/cancel" \
-H "Authorization: Bearer $LUNAPAY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: sandbox-cancel-00001" \
-d '{}'Three Payway installments
Only eligible ARS transactions and local credit cards qualify, with an enabled campaign, account and channel. The total is processed with three installments, not three subscriptions. Without verified enrollment it is unavailable in live.
Development contract · source: Payments · 9f82d06
Next guideInvoicing and issuer