LunaPay® · Documentação

Da primeira cobrança à sua própria integração.

Baixar OpenAPI 3.1

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.

Exemplo de servidor
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.

Exemplo de servidor
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