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.
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.
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.
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