Transactions

Void an authorization

Voids (cancels) an authorization before it is captured, releasing the held funds. Creates a void transaction linked via parent_transaction_id and returns it with 200; read the void outcome from data.status. Pass an Idempotency-Key header to make retries safe. Returns 404 when the authorization is not found — including authorizations that were not created through this API — 409 on an in-flight duplicate key, and 422 when the authorization cannot be voided. On success, API-key-authenticated requests emit a payment.voided webhook.

POST

api

payment

v2026-04

transactions

{id}

void

Void an authorization

curl --request POST \
  --url https://api.fluid.app/api/payment/v2026-04/transactions/{id}/void \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

import requests

url = "https://api.fluid.app/api/payment/v2026-04/transactions/{id}/void"

payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

fetch('https://api.fluid.app/api/payment/v2026-04/transactions/{id}/void', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fluid.app/api/payment/v2026-04/transactions/{id}/void",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fluid.app/api/payment/v2026-04/transactions/{id}/void"

	payload := strings.NewReader("{}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.fluid.app/api/payment/v2026-04/transactions/{id}/void")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fluid.app/api/payment/v2026-04/transactions/{id}/void")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "id": "<string>",
    "action": "purchase",
    "status": "success",
    "amount_cents": 123,
    "currency_code": "<string>",
    "processing_fee_cents": 123,
    "platform_fee_cents": 123,
    "credited_amount_cents": 123,
    "retain_on_success": true,
    "metadata": {},
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "gateway_id": "<string>",
    "payment_method_id": "<string>",
    "card_network": "<string>",
    "parent_transaction_id": "<string>",
    "payment_source": "<string>",
    "gateway_transaction_id": "<string>",
    "reference_token": "<string>",
    "description": "<string>"
  },
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "message": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  },
  "status": "<string>"
}

{
  "message": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "status": "error",
  "message": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  },
  "errors": "<string>"
}

{
  "status": "error",
  "message": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  },
  "errors": "<string>"
}

{
  "status": "error",
  "message": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  },
  "errors": "<string>"
}

Authorizations

Authorization

string

header

required

Merchant API key (fp_live_* for live, fp_test_* for sandbox) or an admin-tier JWT (company admin or root admin). Non-admin JWTs are rejected with 403; live API keys additionally require the merchant's API access to be enabled.

Headers

Idempotency-Key

string

Optional client-generated key (UUID recommended) used to deduplicate retries. The first request with a given key executes normally; a retry with the same key replays that first response with X-Idempotent-Replayed: true for up to 24 hours. A concurrent retry while the first request is still in flight returns 409.

The response cache is keyed on the authenticated merchant and this key ONLY — not on the operation, path, or request body. Use a fresh, unique key per logical request: reusing one key across different operations (for example a purchase and then a capture) replays the first operation's cached status and body instead of performing the second.

Idempotency applies to API-key-authenticated requests only. On JWT-authenticated requests the header is accepted but ignored — no deduplication, no 409, no replay. The cache stores whatever the first execution returned, including error responses such as 404 or 422. Keys longer than 255 characters are rejected with an unhandled 500.

Maximum string length: 255

Path Parameters

string

required

Transaction slug (authorization to void)

Body

application/json

transaction

object

Show child attributes

Response

Void completed

data

object

required

Show child attributes

meta

object

required

Show child attributes

Void an authorization

curl --request POST \
  --url https://api.fluid.app/api/payment/v2026-04/transactions/{id}/void \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

import requests

url = "https://api.fluid.app/api/payment/v2026-04/transactions/{id}/void"

payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

fetch('https://api.fluid.app/api/payment/v2026-04/transactions/{id}/void', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fluid.app/api/payment/v2026-04/transactions/{id}/void",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fluid.app/api/payment/v2026-04/transactions/{id}/void"

	payload := strings.NewReader("{}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.fluid.app/api/payment/v2026-04/transactions/{id}/void")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fluid.app/api/payment/v2026-04/transactions/{id}/void")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "id": "<string>",
    "action": "purchase",
    "status": "success",
    "amount_cents": 123,
    "currency_code": "<string>",
    "processing_fee_cents": 123,
    "platform_fee_cents": 123,
    "credited_amount_cents": 123,
    "retain_on_success": true,
    "metadata": {},
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "gateway_id": "<string>",
    "payment_method_id": "<string>",
    "card_network": "<string>",
    "parent_transaction_id": "<string>",
    "payment_source": "<string>",
    "gateway_transaction_id": "<string>",
    "reference_token": "<string>",
    "description": "<string>"
  },
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "message": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  },
  "status": "<string>"
}

{
  "message": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "status": "error",
  "message": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  },
  "errors": "<string>"
}

{
  "status": "error",
  "message": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  },
  "errors": "<string>"
}

{
  "status": "error",
  "message": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  },
  "errors": "<string>"
}

Overview

Task guides

Portal & Widgets

Endpoints

Auth endpoints

Checkout endpoints

Public SDK endpoints

Member endpoints

Payment gateway endpoints

Cart payment endpoints

Commerce endpoints

Webhooks endpoints

Company admin endpoints (v0)

Analytics

Void an authorization

Authorizations

Headers

Path Parameters

Body

Response