import { createAdminClient } from '@spree/admin-sdk'

const client = createAdminClient({
  baseUrl: 'https://your-store.com',
  secretKey: 'sk_xxx',
})

const label = await client.orders.fulfillments.labels.refund(
  'or_UkLWZg9DAJ',
  'ful_UkLWZg9DAJ',
  'lbl_UkLWZg9DAJ',
)

// 'refunded' when the carrier settled at once, 'refund_requested' when it
// will answer later.
const outcome = label.status

spree api patch /orders/{order_id}/fulfillments/{fulfillment_id}/labels/{id}/refund -d '{ ... }'

{
  "id": "lbl_UkLWZg9DAJ",
  "source": "purchased",
  "status": "refunded",
  "carrier": "ups",
  "carrier_name": "UPS",
  "service": "Ground",
  "tracking_number": "1Z879E930346830004",
  "currency": "USD",
  "format": "pdf",
  "external_id": "shp_2",
  "metadata": {},
  "refunded_at": "2026-01-15T12:00:00.000Z",
  "created_at": "2026-01-15T12:00:00.000Z",
  "updated_at": "2026-01-15T12:00:00.000Z",
  "owner_id": "ful_UkLWZg9DAJ",
  "owner_type": "fulfillment",
  "cost": "7.25",
  "integration_id": null,
  "file_pending": false,
  "download_url": null
}

{
  "error": {
    "code": "processing_error",
    "message": "An uploaded label was not bought through Spree and cannot be refunded — delete it instead"
  }
}