💸 Operaciones Financieras

Reembolsos, confirmaciones y cancelaciones de operaciones previas.

• Reimburse (refund): devolución total o parcial de un pago.

• Confirm Deferred: captura/confirmación de una pre-autorización.

• Cancel Deferred: cancelación de una pre-autorización no capturada.

El gateway (EPN) se detecta automáticamente a partir de la orden original.

Reembolsar (total o parcial) un pago previo

post

Ejecuta un reembolso total o parcial sobre una orden previamente cobrada.

El gateway (Paylands/EPN) se detecta automáticamente a partir de la orden original.

Body:

{
  "order_uuid": "A1B2C3D4-5678-...",
  "amount": 50.00,
  "gateway": "77"
}

Campo	Tipo	Requerido	Descripción
order_uuid	string	✅	UUID de la orden a reembolsar
amount	float	✅	Importe a reembolsar en unidades monetarias (ej: 50.00 = 50€)
gateway	string	❌	ID del comercio (si se quiere forzar uno específico)

Comportamiento por gateway:

• Paylands: POST /payment/refund con marketplace_refunds si aplica.

• EPN: Operations.asmx → RefundByReference con la referencia original.

Respuesta: Estado actualizado de la orden (mismo formato que /orders). El campo order_refunded refleja el total acumulado de reembolsos.

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Body

application/json

Other propertiesanyOptional

Responses

200

Reembolso procesado. Devuelve el estado actualizado de la orden.

application/json

anyOptional

400

order_uuid o amount no proporcionados, o amount ≤ 0.

401

Token JWT inválido o ausente.

403

La orden no pertenece al usuario autenticado.

404

Orden no encontrada.

422

Validation Error

application/json

502

Error en la pasarela al procesar el reembolso.

post

/reimburse

HTTPcURLJavaScriptPython

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

{
  "ANY_ADDITIONAL_PROPERTY": "anything"
}

No content

Confirmar (capturar) una pre-autorización

post

Confirma (captura) una pre-autorización previamente creada con operative=DEFERRED.

El importe de captura puede ser menor o igual al pre-autorizado (captura parcial).

Body:

{
  "order_uuid": "A1B2C3D4-5678-...",
  "amount": 120.00,
  "gateway": "77"
}

Campo	Tipo	Requerido	Descripción
order_uuid	string	✅	UUID de la orden pre-autorizada
amount	float	✅	Importe a capturar en unidades monetarias
gateway	string	❌	ID del comercio (si se quiere forzar uno específico)

Comportamiento por gateway:

• Paylands: POST /payment/confirmation.

• EPN: Operations.asmx → PreauthorizationConfirmByReference.

Respuesta: Estado actualizado de la orden.

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Body

application/json

Other propertiesanyOptional

Responses

200

Pre-autorización confirmada. Devuelve el estado actualizado de la orden.

application/json

anyOptional

400

order_uuid o amount no proporcionados, o amount ≤ 0.

401

Token JWT inválido o ausente.

403

La orden no pertenece al usuario autenticado.

404

Orden no encontrada.

422

Validation Error

application/json

502

Error en la pasarela al confirmar.

post

/confirmDeferred

HTTPcURLJavaScriptPython

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

{
  "ANY_ADDITIONAL_PROPERTY": "anything"
}

No content

Cancelar una pre-autorización no capturada

post

Cancela una pre-autorización que aún no ha sido capturada (confirmada).

Libera los fondos retenidos en la tarjeta del cliente.

Body:

{
  "order_uuid": "A1B2C3D4-5678-...",
  "gateway": "77"
}

Campo	Tipo	Requerido	Descripción
order_uuid	string	✅	UUID de la orden pre-autorizada a cancelar
gateway	string	❌	ID del comercio (si se quiere forzar uno específico)

Comportamiento por gateway:

• Paylands: POST /payment/cancellation.

• EPN: Operations.asmx → PreauthorizationCancelByReference.

Respuesta: Estado actualizado de la orden.

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Body

application/json

Other propertiesanyOptional

Responses

200

Pre-autorización cancelada. Devuelve el estado actualizado de la orden.

application/json

anyOptional

400

order_uuid no proporcionado.

401

Token JWT inválido o ausente.

403

La orden no pertenece al usuario autenticado.

404

Orden no encontrada.

422

Validation Error

application/json

502

Error en la pasarela al cancelar.

post

/cancelDeferred

HTTPcURLJavaScriptPython

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

{
  "ANY_ADDITIONAL_PROPERTY": "anything"
}

No content