LunaPay® · Documentación

De tu primer cobro a una integración propia.

Descargar OpenAPI 3.1

Revisado el 19/09/2026

Checkout y confirmaciones

El servidor calcula la orden a partir de precios propios del comercio.

Ejemplos para ejecutar en tu servidor con datos propios de sandbox. Las claves nunca se incluyen en el frontend. Esta documentación no habilita operaciones live.

Prepará un checkout

Con cliente, precio y contrato aprobados, creá la sesión desde tu servidor. Reemplazá los identificadores de ejemplo por UUID de tu sandbox. La respuesta contiene data.url para compartir con el comprador.

Ejemplo 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
    }
  ]
}'

Consultá el estado

Consultá el pago con su identificador. Un regreso exitoso del navegador, una captura o la creación de una sesión no acreditan dinero. Ante una respuesta incierta, consultá y conciliá antes de intentar otro cobro.

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

Devoluciones

Solicitar un reembolso no confirma su ejecución. Requiere scope financiero delegado por owner/admin con MFA, capacidad del proveedor y respaldo de la política contractual. Las devoluciones parciales y posteriores a un retiro conservan su trazabilidad.

Ejemplo 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 desarrollo · fuente: Payments · 9f82d06

Siguiente guíaSuscripciones y cuotas