Refunds & voids

Void unused labels and receive the full credit back to your wallet.

A refund in SendIt is a label void: voiding a label credits the full purchase amount back to your wallet.

Void a label

curl -X POST https://api.sendit.mx/v1/shipments/clxq1w2e3r4t5y6u7i8o9p0a/label/void \
  -H "X-API-Key: sk_test_..." \
  -H "Idempotency-Key: 7c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f"

Voiding is allowed while the shipment is in LABEL_PURCHASED or READY_FOR_PICKUP, that is, before the carrier collects the package. On void:

The full original charge is credited to your wallet (monedero), including any plan overage you were charged for that label.
The label becomes VOIDED, with voidedAt, refundedAmount, and refundedAt.
The shipment moves to CANCELLED and the event is recorded.

The credit returns to the same balance it came from. A test-mode purchase is credited to the virtual balance. A live purchase is credited to the real balance.

{
  "success": true,
  "data": {
    "id": "clxlbl456abc789def012ghi",
    "status": "VOIDED",
    "voidedAt": "2026-07-17T12:00:00.000Z",
    "refundedAmount": "326.82",
    "refundedAt": "2026-07-17T12:00:00.000Z"
  }
}

The credit shows up immediately in GET /v1/wallet/transactions.

Cross-state rules with insurance

Labels with an open insurance claim can’t be voided, and vice versa:

Code	When	How to resolve it
`CLAIM_PENDING_NO_REFUND_ALLOWED`	The shipment has an open claim (the `claimId` is in the response)	Resolve or cancel the claim first
`SHIPMENT_REFUNDED_NO_CLAIMS_ALLOWED`	Filing a claim on an already-voided label	No insurance applies to voided labels — the cost was already refunded

Overweight adjustments billed by the carrier after delivery are not refunded automatically: they are charges for service already rendered. If you disagree with an overweight charge, dispute it directly with the carrier, tracking number in hand.

In test mode

Voiding a test label credits the virtual balance, with no real-world effects. You can also reset the test balance with POST /v1/wallet/test/reset. See Test mode.

Refunds & voids

Void a label

Cross-state rules with insurance

Overweight charges

In test mode