Cancelar operación

PUT

/flow/v1/operations/{operationUuid}/cancel

Cancela una operación cuando todavía es elegible. Se usa para la gestión operativa de cobros sin finalizar.

La cancelación se permite cuando la operación está en CREATED, o en OPENED y no tiene una transacción pendiente (es decir, el pagador no está en medio de la autorización del pago en su banco). Responde con 204 No Content si tiene éxito. Idempotente: si la operación ya está CANCELLED, no realiza ninguna acción y devuelve igualmente 204. Devuelve 409 si la operación está en otro estado final (COMPLETED, REJECTED, EXPIRED, NOT_DELIVERED) o tiene una transacción pendiente. Si la operación cancelada era la única activa de su flujo, el flujo también pasa a CANCELLED.

Autorizaciones

OAuth2Board

OAuth2 para Dashboard (SPA) con Authorization Code (se espera PKCE)

authorizationCode Flow

Authorization URL"https://nc-api-uat.zertiban.com/idp/oauth2/authorize"

Token URL"https://nc-api-uat.zertiban.com/idp/oauth2/token"

Scopes:

• "DASHBOARD"Dashboard scope

o

OAuth2M2M

OAuth2 para integraciones M2M con Client Credentials

clientCredentials Flow

Token URL"https://nc-api-uat.zertiban.com/idp/oauth2/token"

Scopes:

• "API"M2M API scope

Parámetros

Header Parameters

x-tenant-id*

Identificador del tenant que contiene el UUID del negocio

Tipo

string

Requerido

Path Parameters

operationUuid*

UUID de la operación

Tipo

string

Requerido

Formato

"uuid"

Respuestas

Operación cancelada correctamente (sin contenido)

PUT

/flow/v1/operations/{operationUuid}/cancel

Playground

Autorización

OAuth2Board

Headers

x-tenant-id*

Variables

Key

Value

operationUuid*

Ejemplos