💳 Pagos Directos

Ejecución inmediata de cobros (sin programación).

Flujos soportados con EPN:

• MOTO (Mail Order / Telephone Order): cobro con token de tarjeta sin 3DS.

• MIT (Merchant Initiated Transaction): cobro recurrente iniciado por el comercio.

• PayByLink / Checkout: si no se envía card, se genera un enlace de pago.

• DEFERRED: pre-autorización que se confirma o cancela posteriormente.

El gateway se determina automáticamente por el campo payment_gateway del comercio.

Ejecutar un pago directo (inmediato)

post

Ejecuta un pago directo (inmediato, sin programación).

Flujos soportados:

1. Pago MOTO (Mail Order / Telephone Order)

moto=true, requiere card (UUID Paylands o token EPN).

• Paylands: crea orden → ejecuta /payment/moto.

• Si es REFUSED en el primer intento, crea automáticamente una nueva orden y reintenta 1 vez.

• EPN: ejecuta TokenOperations.asmx → Sale directamente.

2. Pago MIT (Merchant Initiated Transaction)

mit=true, requiere card.

• Paylands: crea orden → ejecuta /payment/direct.

• EPN: ejecuta Sale con PPS_TokenUsageReason=R (recurring).

3. PayLink / Checkout

paylink=true, sin card, sin moto/mit.

• Paylands: crea orden y devuelve URLs de checkout.

• EPN: genera PayByLink via PayByLink.asmx → GenerateID.

4. Pre-autorización (DEFERRED)

operative="DEFERRED". La orden queda en estado pre-autorizado. Posteriormente se confirma con /confirmDeferred o cancela con /cancelDeferred.

Body (DirectPayment):

{
  "reservation": {
    "id": "BOOK-123",
    "card": "FCE5AB1B-5608-4EC3-9168-247CB19B2D16"
  },
  "gateway": {
    "id": "77",
    "moto": true,
    "mit": false,
    "operative": "AUTHORIZATION",
    "currency": "EUR",
    "amount": 150.00,
    "description": "Reserva habitación doble",
    "return_url_ok": "https://hotel.com/ok",
    "return_url_ko": "https://hotel.com/ko",
    "process_url": "https://hotel.com/webhook"
  },
  "paylink": false
}

Respuesta exitosa (MOTO/MIT Paylands): Devuelve la respuesta completa de Paylands con order.uuid, order.status, order.paid, etc.

Respuesta exitosa (EPN):

{
  "ok": true,
  "gateway": "EPN",
  "order": {
    "uuid": "BOOK-123_1735689600_A1B2C3D4",
    "status": "ACCEPTED",
    "amount": 15000,
    "currency": "EUR",
    "paid": true
  },
  "epn_response": { ... }
}

Respuesta PayLink:

{
  "ok": true,
  "order": { "uuid": "...", ... },
  "paylink": true,
  "paylink_url": "https://pps.ecopaynet.com/Payment.aspx?id=..."
}

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Body

application/json

Payload completo para ejecutar un pago directo (inmediato).

paylinkbooleanOptional

Si true, solo genera la orden/paylink sin ejecutar MOTO/MIT. La respuesta incluirá las URLs de checkout.

Default: false

Responses

200

Pago ejecutado. La respuesta varía según el gateway y tipo de operación.

application/json

anyOptional

400

Comercio no encontrado o datos inválidos.

401

Token JWT inválido o ausente.

402

Pago rechazado por la pasarela.

422

Validation Error

application/json

500

Error interno (no se recibió order_uuid, etc.).

502

Error de la pasarela externa.

503

Pasarela externa no disponible.

post

/directPayment

HTTPcURLJavaScriptPython

POST /directPayment HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 294

{
  "gateway": {
    "amount": 150,
    "currency": "EUR",
    "description": "Reserva habitación doble",
    "id": "77",
    "mit": false,
    "moto": true,
    "operative": "AUTHORIZATION",
    "process_url": "https://hotel.com/api/webhook"
  },
  "paylink": false,
  "reservation": {
    "card": "FCE5AB1B-5608-4EC3-9168-247CB19B2D16",
    "id": "BOOK-2025-00123"
  }
}

No content