LunaPay® · Documentação

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

Baixar OpenAPI 3.1

Revisado em 19/09/2026

Checkout e confirmações

O servidor calcula a ordem a partir dos preços do negócio.

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.

Prepare um checkout

Com cliente, preço e contrato aprovados, crie a sessão no seu servidor. Substitua identificadores de exemplo por UUID do seu sandbox. A resposta contém data.url para compartilhar com o comprador.

Exemplo de servidor
curl "https://payments.lunapay.ar/v1/checkout-sessions" \
  -H "Authorization: Bearer $LUNAPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: sandbox-order-00001" \
  -d '{
  "reference": "sandbox-order-00001",
  "contractId": "CONTRACT_UUID",
  "customerId": "CUSTOMER_UUID",
  "currency": "ARS",
  "items": [
    {
      "priceId": "PRICE_UUID",
      "quantity": 1
    }
  ]
}'

Consulte o estado

Consulte o pagamento pelo ID. Retorno do navegador, captura de tela ou criação de sessão não comprovam dinheiro recebido. Em resultado incerto, consulte e concilie antes de tentar outra cobrança.

Exemplo de servidor
curl "https://payments.lunapay.ar/v1/payments/PAYMENT_UUID" \
  -H "Authorization: Bearer $LUNAPAY_API_KEY"

Reembolsos

Solicitar reembolso não confirma execução. Exige scope financeiro delegado por owner/admin com MFA, capacidade do provedor e evidência da política contratual. Reembolsos parciais e posteriores à retirada preservam a rastreabilidade.

Exemplo de servidor
curl "https://payments.lunapay.ar/v1/refunds" \
  -H "Authorization: Bearer $LUNAPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: sandbox-refund-00001" \
  -d '{
  "orderId": "ORDER_UUID",
  "amountMinor": "10000",
  "reason": "Buyer request",
  "feePolicy": "proportional",
  "policyEvidence": "ACCEPTED_CONTRACT_VERSION"
}'

Contrato de desenvolvimento · fonte: Payments · 9f82d06

Próximo guiaAssinaturas e parcelas