Revisado em 19/09/2026
Assinaturas e parcelas
Uma assinatura cria ciclos. Uma compra parcelada continua sendo uma venda.
Execute os exemplos no seu servidor com seus próprios dados de sandbox. Nunca inclua chaves no frontend. Esta documentação não habilita operações live.
Automática ou manual
automatic_recurring exige conta e mandato válido. manual_renewal cria uma nova solicitação que o comprador paga a cada período. Não se presume que carteiras ou transferências aceitem débito automático.
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
}'Teste e cancelamento
O teste é configurado no preço recorrente. Um mês grátis termina na mesma data do mês seguinte, ajustada ao último dia válido. Sem mandato não se promete cobrança automática. O cancelamento do mandato é assíncrono; verifique o estado.
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 '{}'Três parcelas Payway
Apenas operações ARS e cartões de crédito locais elegíveis, com campanha, conta e canal habilitados. O total é processado em três parcelas, não três assinaturas. Sem adesão verificada, não é oferecido em live.
Contrato de desenvolvimento · fonte: Payments · 9f82d06
Próximo guiaFaturamento e emissor