From 3d9a06bbe1a4bc90605bce0804c9613403632531 Mon Sep 17 00:00:00 2001 From: Aaryaman Bhute Date: Thu, 30 Jul 2026 19:21:44 +0000 Subject: [PATCH 1/2] docs(transactions): document the 501 response on the cancel endpoint --- mintlify/openapi.yaml | 8 +++++++- openapi.yaml | 8 +++++++- .../transactions_{transactionId}_cancel.yaml | 15 ++++++++++++++- 3 files changed, 28 insertions(+), 3 deletions(-) diff --git a/mintlify/openapi.yaml b/mintlify/openapi.yaml index 75833f86e..957906258 100644 --- a/mintlify/openapi.yaml +++ b/mintlify/openapi.yaml @@ -4394,7 +4394,7 @@ paths: $ref: '#/components/schemas/CancelTransactionRequest' responses: '200': - description: Cancellation requested successfully + description: The banking partner accepted the cancellation request. The transfer reaches its cancelled state once the partner confirms it, so the transaction returned here may still report its pre-cancellation status. content: application/json: schema: @@ -4429,6 +4429,12 @@ paths: application/json: schema: $ref: '#/components/schemas/Error500' + '501': + description: Not implemented for this payment rail. Cancellation depends on the banking partner settling the transfer exposing a cancellation facility; rails without one — wires, and ACH at partners that do not support it — return `501 NOT_IMPLEMENTED`. + content: + application/json: + schema: + $ref: '#/components/schemas/Error501' /crypto/estimate-withdrawal-fee: post: summary: Estimate crypto withdrawal fee diff --git a/openapi.yaml b/openapi.yaml index 75833f86e..957906258 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -4394,7 +4394,7 @@ paths: $ref: '#/components/schemas/CancelTransactionRequest' responses: '200': - description: Cancellation requested successfully + description: The banking partner accepted the cancellation request. The transfer reaches its cancelled state once the partner confirms it, so the transaction returned here may still report its pre-cancellation status. content: application/json: schema: @@ -4429,6 +4429,12 @@ paths: application/json: schema: $ref: '#/components/schemas/Error500' + '501': + description: Not implemented for this payment rail. Cancellation depends on the banking partner settling the transfer exposing a cancellation facility; rails without one — wires, and ACH at partners that do not support it — return `501 NOT_IMPLEMENTED`. + content: + application/json: + schema: + $ref: '#/components/schemas/Error501' /crypto/estimate-withdrawal-fee: post: summary: Estimate crypto withdrawal fee diff --git a/openapi/paths/transactions/transactions_{transactionId}_cancel.yaml b/openapi/paths/transactions/transactions_{transactionId}_cancel.yaml index 7d2899ee5..172f9cb17 100644 --- a/openapi/paths/transactions/transactions_{transactionId}_cancel.yaml +++ b/openapi/paths/transactions/transactions_{transactionId}_cancel.yaml @@ -31,7 +31,10 @@ post: $ref: ../../components/schemas/transactions/CancelTransactionRequest.yaml responses: '200': - description: Cancellation requested successfully + description: >- + The banking partner accepted the cancellation request. The transfer + reaches its cancelled state once the partner confirms it, so the + transaction returned here may still report its pre-cancellation status. content: application/json: schema: @@ -68,3 +71,13 @@ post: application/json: schema: $ref: ../../components/schemas/errors/Error500.yaml + '501': + description: >- + Not implemented for this payment rail. Cancellation depends on the + banking partner settling the transfer exposing a cancellation facility; + rails without one — wires, and ACH at partners that do not support it — + return `501 NOT_IMPLEMENTED`. + content: + application/json: + schema: + $ref: ../../components/schemas/errors/Error501.yaml From 0974dfd07c2a05eb9d2fbcf9a2308e9bd8268437 Mon Sep 17 00:00:00 2001 From: Aaryaman Bhute Date: Thu, 6 Aug 2026 17:39:11 +0000 Subject: [PATCH 2/2] docs(transactions): document the 501 response on the cancel endpoint Co-Authored-By: whoisglover --- mintlify/openapi.yaml | 2 +- openapi.yaml | 2 +- .../transactions/transactions_{transactionId}_cancel.yaml | 8 ++++---- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/mintlify/openapi.yaml b/mintlify/openapi.yaml index 957906258..0242db2b6 100644 --- a/mintlify/openapi.yaml +++ b/mintlify/openapi.yaml @@ -4430,7 +4430,7 @@ paths: schema: $ref: '#/components/schemas/Error500' '501': - description: Not implemented for this payment rail. Cancellation depends on the banking partner settling the transfer exposing a cancellation facility; rails without one — wires, and ACH at partners that do not support it — return `501 NOT_IMPLEMENTED`. + description: Cancellation is not yet available for the payment rail settling this transfer. Support is being rolled out per rail and per banking partner; transfers on a rail that is not covered yet return `501 NOT_IMPLEMENTED`. Track availability in the Grid changelog. content: application/json: schema: diff --git a/openapi.yaml b/openapi.yaml index 957906258..0242db2b6 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -4430,7 +4430,7 @@ paths: schema: $ref: '#/components/schemas/Error500' '501': - description: Not implemented for this payment rail. Cancellation depends on the banking partner settling the transfer exposing a cancellation facility; rails without one — wires, and ACH at partners that do not support it — return `501 NOT_IMPLEMENTED`. + description: Cancellation is not yet available for the payment rail settling this transfer. Support is being rolled out per rail and per banking partner; transfers on a rail that is not covered yet return `501 NOT_IMPLEMENTED`. Track availability in the Grid changelog. content: application/json: schema: diff --git a/openapi/paths/transactions/transactions_{transactionId}_cancel.yaml b/openapi/paths/transactions/transactions_{transactionId}_cancel.yaml index 172f9cb17..180e0f33b 100644 --- a/openapi/paths/transactions/transactions_{transactionId}_cancel.yaml +++ b/openapi/paths/transactions/transactions_{transactionId}_cancel.yaml @@ -73,10 +73,10 @@ post: $ref: ../../components/schemas/errors/Error500.yaml '501': description: >- - Not implemented for this payment rail. Cancellation depends on the - banking partner settling the transfer exposing a cancellation facility; - rails without one — wires, and ACH at partners that do not support it — - return `501 NOT_IMPLEMENTED`. + Cancellation is not yet available for the payment rail settling this + transfer. Support is being rolled out per rail and per banking partner; + transfers on a rail that is not covered yet return + `501 NOT_IMPLEMENTED`. Track availability in the Grid changelog. content: application/json: schema: