Sale

A sale — an order where you are the seller — with the buyer, the address to ship to, your seller fee, and your payout. refunded is the total you refunded on this sale so far, in your selling currency; 0 when nothing was refunded.

actions
Type: array of object
required

The operations that can act on this sale now, filtered by the permissions of your key.

Properties: 3
buyer
Type:
required

The other party on an order — the buyer on a sale, the seller on a purchase — with their public profile and reputation.

Properties: 7
completedAt
Type: Format: date-timenullable
required

When the order closed. null if still open.
currency
Type: stringenum
required

The currency every amount in this response is expressed in. Sales are in your selling currency; purchases are in the currency you paid.
values
- USD
  
  US Dollar.
- EUR
  
  Euro.
- GBP
  
  British Pound.
- CAD
  
  Canadian Dollar.
- CHF
  
  Swiss Franc.
- SEK
  
  Swedish Krona.
- DKK
  
  Danish Krone.
- NOK
  
  Norwegian Krone.
- PLN
  
  Polish Złoty.
- HUF
  
  Hungarian Forint.
deliveredAt
Type: Format: date-timenullable
required

When the parcel was delivered. null if not yet.
items
Type: array of object
required

The items in the order, each tied to the inventory line it sold from.

Properties: 12
labelState
Type: stringenumnullable
required

For a sale whose shipping CardNexus manages: created once the shipping label exists, none before. null when you ship the order yourself.
values
- none
  
  CardNexus manages the shipping and the label does not exist yet.
- created
  
  The shipping label exists.
metadata
Type:
required

Your own key/value pairs on this sale. Empty when you haven't set any. Keys start with a letter and may contain letters, digits, _, . and -, up to 64 characters; values are strings of up to 500 characters. A sale holds at most 50 keys. The buyer never sees them.

Properties: 1
orderNumber
Type: string
required

Human-readable order reference, shared across the sale and the purchase, e.g. OR-ASNBC-1.
payout
Type:
required

Your payout for a sale and its transfer timeline.

Properties: 3
placedAt
Type: stringFormat: date-time
required

When the order was placed.
refunded
Type:
required

A monetary amount as a decimal in the currency's major unit paired with its currency code — { amount: 14.99, currency: "USD" } means $14.99.

Properties: 2
sellerFee
Type:
required

The seller fee CardNexus charged on a sale.

Properties: 2
shipBy
Type: Format: date-timenullable
required

The ship-by deadline. Set while the order is pending_shipment or cancellation_requested; null otherwise.
shippedAt
Type: Format: date-timenullable
required

When the order was marked shipped. null if not yet.
shippingAddress
Type:
required

A postal address an order ships to.

Properties: 8
shippingAmount
Type:
required

A monetary amount as a decimal in the currency's major unit paired with its currency code — { amount: 14.99, currency: "USD" } means $14.99.

Properties: 2
shippingManagedByCardNexus
Type: boolean
required

true when CardNexus manages shipping on this sale: the buyer paid CardNexus for the shipping, and you ship with a label generated on CardNexus — POST /v1/sales/{orderNumber}/mark-shipped returns 409 SHIPPING_MANAGED_BY_CARDNEXUS. false when you ship the order yourself. Set when the order is placed: a later change to your shipping setting only applies to new orders.
shippingService
Type: stringenum
required

The shipping the buyer paid for. tracked ships with a tracking number. untracked ships as a letter, which may have no tracking number.
values
- tracked
  
  The order ships with a tracking number.
- untracked
  
  The order ships as a letter, which may have no tracking number.
status
Type: enum
required

Where the order is in its lifecycle. pending_shipment is awaiting dispatch; shipped and delivered track the parcel; completed is closed and paid out; cancelled_* and resolved_* are the terminal cancellation and dispute outcomes.
values
- pending_shipment
  
  Awaiting dispatch.
- cancellation_requested
  
  The buyer asked to cancel; awaiting a response.
- cancelled_buyer
  
  Cancelled — the buyer's cancellation was accepted.
- cancelled_seller
  
  Cancelled by the seller.
- cancelled_auto
  
  Cancelled automatically by CardNexus.
- shipped
  
  On its way to the buyer.
- delivered
  
  Delivered to the buyer.
- completed
  
  Closed and paid out.
subtotal
Type:
required

A monetary amount as a decimal in the currency's major unit paired with its currency code — { amount: 14.99, currency: "USD" } means $14.99.

Properties: 2
untrackedCloseAt
Type: Format: date-timenullable
required

When this untracked order closes on its own: it completes and the seller is paid, unless a dispute is opened before then. null on tracked orders, and until an untracked order ships.
updatedAt
Type: stringFormat: date-time
required

When the order last changed.
webUrl
Type: string
required

The order page on cardnexus.com. The link carries no credentials: a signed-in person lands on the order.

Examples

{
  "orderNumber": "OR-ASNBC-1",
  "status": "shipped",
  "placedAt": "2026-06-13T15:02:00.000Z",
  "updatedAt": "2026-06-14T09:12:00.000Z",
  "shippedAt": "2026-06-14T09:12:00.000Z",
  "deliveredAt": null,
  "completedAt": null,
  "shippingService": "tracked",
  "webUrl": "https://cardnexus.com/orders/OR-ASNBC-1",
  "shipBy": null,
  "untrackedCloseAt": null,
  "currency": "EUR",
  "items": [
    {
      "productId": 50212,
      "productName": "Dark Magician (SDMY-EN001)",
      "imageUrl": "https://images.cardnexus.com/yugioh/SDMY-EN001.png",
      "condition": "NM",
      "language": "en",
      "finish": "Standard",
      "graded": null,
      "quantity": 2,
      "unitPrice": {
        "amount": 4.5,
        "currency": "EUR"
      },
      "lineTotal": {
        "amount": 9,
        "currency": "EUR"
      },
      "inventoryId": "665f3a2b1c8d4e9f7a6b5c4d",
      "customId": "YRG|5555-5DS1-2EX-006-f-2-2008-08-01"
    }
  ],
  "subtotal": {
    "amount": 9,
    "currency": "EUR"
  },
  "shippingAmount": {
    "amount": 3.5,
    "currency": "EUR"
  },
  "shippingManagedByCardNexus": false,
  "sellerFee": {
    "percentage": 5,
    "amount": {
      "amount": 0.45,
      "currency": "EUR"
    }
  },
  "payout": {
    "amount": {
      "amount": 12.05,
      "currency": "EUR"
    },
    "eligibleAt": "2026-06-21T09:12:00.000Z",
    "paidOutAt": null
  },
  "refunded": {
    "amount": 0,
    "currency": "EUR"
  },
  "buyer": {
    "id": "665f3a2b1c8d4e9f7a6b5c4d",
    "username": "north_arena_tcg",
    "avatarUrl": "https://images.cardnexus.com/avatars/north_arena_tcg.png",
    "country": "GB",
    "type": "individual",
    "rating": {
      "average": 4.9,
      "count": 51
    },
    "reliability": null
  },
  "shippingAddress": {
    "recipientName": "Marie Dubois",
    "line1": "14 Rue des Lilas",
    "line2": null,
    "city": "Lyon",
    "state": null,
    "postalCode": "69003",
    "countryCode": "FR",
    "phone": null
  },
  "metadata": {
    "fulfillment_stage": "packed",
    "internal_order_ref": "SO-10432"
  },
  "labelState": null,
  "actions": [
    {
      "id": "update-tracking",
      "method": "POST",
      "path": "/v1/sales/OR-ASNBC-1/tracking"
    }
  ]
}

PurchaseRefund

SaleDetail