Cancel charge

POST/api/v1/bank/wallet/charge/{charge_uuid}/cancel/{wallet_uuid}/Bearer Token

---

Request headers

Header	Value	Required
Authorization	Bearer {A55_ACCESS_TOKEN}	Yes
Content-Type	application/json	Yes
Idempotency-Key	UUID v4	Recommended

Path parameters

Field	Type	Required	Description
charge_uuid	string (UUID)	Yes	Charge to cancel
wallet_uuid	string (UUID)	Yes	Wallet that owns the charge

Request body

Field	Type	Required	Description
reason	string	No	Cancellation reason for reconciliation

---

Response fields

Field	Type	Description
charge_uuid	string	Cancelled charge identifier
wallet_uuid	string	Wallet that owned the charge
status	string	canceled on success
message	object	Additional details or empty object on success

---

HTTP status codes

Status	Description
200	Charge cancelled successfully
400	Charge is not in a cancellable state
401	Invalid or expired Bearer token
403	Insufficient permissions for this wallet
404	Charge or wallet not found
409	Charge already cancelled or settled
422	Validation error
429	Rate limit exceeded
500	Internal server error — retry with exponential backoff

---

Code examples

cURL

curl -s -X POST "https://core-manager.a55.tech/api/v1/bank/wallet/charge/a1b2c3d4-e5f6-7890-abcd-ef1234567890/cancel/f47ac10b-58cc-4372-a567-0e02b2c3d479/" \
  -H "Authorization: Bearer $A55_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \
  -d '{"reason": "Customer requested cancellation before shipment"}'

Python

import requests
import os

token = os.environ["A55_ACCESS_TOKEN"]
base = os.environ.get("A55_API_URL", "https://core-manager.a55.tech")

charge_uuid = "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
wallet_uuid = "f47ac10b-58cc-4372-a567-0e02b2c3d479"

try:
    response = requests.post(
        f"{base}/api/v1/bank/wallet/charge/{charge_uuid}/cancel/{wallet_uuid}/",
        json={"reason": "Customer requested cancellation before shipment"},
        headers={
            "Authorization": f"Bearer {token}",
            "Content-Type": "application/json",
            "Idempotency-Key": "550e8400-e29b-41d4-a716-446655440000",
        },
    )
    response.raise_for_status()
    result = response.json()
    print(f"Cancelled: {result['charge_uuid']} — Status: {result['status']}")
except requests.exceptions.HTTPError as e:
    print(f"HTTP {e.response.status_code}: {e.response.json()}")
except requests.exceptions.RequestException as e:
    print(f"Request failed: {e}")

Node.js

const token = process.env.A55_ACCESS_TOKEN;
const base = process.env.A55_API_URL || "https://core-manager.a55.tech";

const chargeUuid = "a1b2c3d4-e5f6-7890-abcd-ef1234567890";
const walletUuid = "f47ac10b-58cc-4372-a567-0e02b2c3d479";

try {
  const response = await fetch(
    `${base}/api/v1/bank/wallet/charge/${chargeUuid}/cancel/${walletUuid}/`,
    {
      method: "POST",
      headers: {
        Authorization: `Bearer ${token}`,
        "Content-Type": "application/json",
        "Idempotency-Key": "550e8400-e29b-41d4-a716-446655440000",
      },
      body: JSON.stringify({
        reason: "Customer requested cancellation before shipment",
      }),
    }
  );

  if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
  const result = await response.json();
  console.log(`Cancelled: ${result.charge_uuid} — Status: ${result.status}`);
} catch (error) {
  console.error("Cancel failed:", error.message);
}

---

Error response example

{
  "charge_uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "error",
  "message": [
    {
      "code": "CANCEL_NOT_ALLOWED",
      "source": "charge",
      "description": "Charge has already been settled and cannot be cancelled. Use refund instead."
    }
  ]
}

---

Refund charge →Refund a charge that has already been captured.Get charge →Verify cancellation status by polling the charge.Webhooks →Receive a webhook when the cancellation is processed.