SellAuth

Invoices

Get Invoices

Retrieves the invoices.

GET
/v1/shops/{shopId}/invoices

Authorization

AuthorizationRequiredBearer <token>

You can retrieve your API key by visiting your dashboard and clicking Account > API.

In: header

Request Body

application/jsonOptional
pageinteger

Must be at least 1.

perPageinteger

Must be at least 1. Must not be greater than 100.

orderColumnstring
Value in: "id" | "price_usd" | "paid_usd" | "created_at" | "completed_at"
orderDirectionstring
Value in: "asc" | "desc"
idstring
statusesarray<string>
emailstring
gatewaysobject
payment_method_idsobject
created_at_startstring

Must be a valid date.

created_at_endstring

Must be a valid date. Must be a date after created_at_start.

completed_at_startstring

Must be a valid date.

completed_at_endstring

Must be a valid date. Must be a date after completed_at_start.

product_namestring
variant_namestring
coupon_codestring
ipstring
discord_idstring
discord_usernamestring
deliverablestring
custom_fieldstring
archivedstring
manualstring
external_id_typestring
external_id_valuestring
cashapp_notestring
paypalff_notestring
venmo_notestring
customer_idstring
allboolean

Path Parameters

shopIdRequiredinteger

The shop ID.

curl -X GET "https://api.sellauth.com/v1/shops/{shopId}/invoices" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "page": 53,
    "perPage": 1,
    "orderColumn": "completed_at",
    "orderDirection": "asc",
    "id": "culpa",
    "statuses": [
      "refunded"
    ],
    "email": "morgan93@example.net",
    "gateways": null,
    "payment_method_ids": null,
    "created_at_start": "2026-07-23T12:49:44",
    "created_at_end": "2084-07-01",
    "completed_at_start": "2026-07-23T12:49:44",
    "completed_at_end": "2084-07-01",
    "product_name": "culpa",
    "variant_name": "culpa",
    "coupon_code": "culpa",
    "ip": "culpa",
    "discord_id": "culpa",
    "discord_username": "culpa",
    "deliverable": "culpa",
    "custom_field": "culpa",
    "archived": null,
    "manual": null,
    "external_id_type": "culpa",
    "external_id_value": "culpa",
    "cashapp_note": "culpa",
    "paypalff_note": "culpa",
    "venmo_note": "culpa",
    "customer_id": "culpa",
    "all": false
  }'

{
  "message": "Unauthenticated."
}

Get Invoice

Retrieves a specific invoice.

GET
/v1/shops/{shopId}/invoices/{invoiceId}

Authorization

AuthorizationRequiredBearer <token>

You can retrieve your API key by visiting your dashboard and clicking Account > API.

In: header

Path Parameters

shopIdRequiredinteger

The shop ID.

invoiceIdRequiredstring

The invoice ID or unique ID.

curl -X GET "https://api.sellauth.com/v1/shops/{shopId}/invoices/971" \
  -H "Authorization: Bearer <token>"

{
  "message": "Unauthenticated."
}

POST
/v1/shops/{shopId}/invoices/{invoiceId}/status

Authorization

AuthorizationRequiredBearer <token>

You can retrieve your API key by visiting your dashboard and clicking Account > API.

In: header

Request Body

application/jsonRequired
statusRequiredstring
Value in: "completed" | "cancelled" | "failed" | "refunded"

Path Parameters

shopIdRequiredstring
invoiceIdRequiredstring
curl -X POST "https://api.sellauth.com/v1/shops/culpa/invoices/culpa/status" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "failed"
  }'

Archive Invoice

Marks an invoice as archived.

POST
/v1/shops/{shopId}/invoices/{invoiceId}/archive

Authorization

AuthorizationRequiredBearer <token>

You can retrieve your API key by visiting your dashboard and clicking Account > API.

In: header

Path Parameters

shopIdRequiredinteger

The shop ID.

invoiceIdRequirednumeric

The invoice ID.

curl -X POST "https://api.sellauth.com/v1/shops/{shopId}/invoices/{invoiceId}/archive" \
  -H "Authorization: Bearer <token>"

Unarchive Invoice

Marks an invoice as unarchived.

POST
/v1/shops/{shopId}/invoices/{invoiceId}/unarchive

Authorization

AuthorizationRequiredBearer <token>

You can retrieve your API key by visiting your dashboard and clicking Account > API.

In: header

Path Parameters

shopIdRequiredinteger

The shop ID.

invoiceIdRequirednumeric

The invoice ID.

curl -X POST "https://api.sellauth.com/v1/shops/{shopId}/invoices/{invoiceId}/unarchive" \
  -H "Authorization: Bearer <token>"

Cancel Invoice

Marks an invoice as cancelled.

POST
/v1/shops/{shopId}/invoices/{invoiceId}/cancel

Authorization

AuthorizationRequiredBearer <token>

You can retrieve your API key by visiting your dashboard and clicking Account > API.

In: header

Path Parameters

shopIdRequiredinteger

The shop ID.

invoiceIdRequirednumeric

The invoice ID.

curl -X POST "https://api.sellauth.com/v1/shops/{shopId}/invoices/{invoiceId}/cancel" \
  -H "Authorization: Bearer <token>"

Refund Invoice

Marks an invoice as refunded.

POST
/v1/shops/{shopId}/invoices/{invoiceId}/refund

Authorization

AuthorizationRequiredBearer <token>

You can retrieve your API key by visiting your dashboard and clicking Account > API.

In: header

Path Parameters

shopIdRequiredinteger

The shop ID.

invoiceIdRequirednumeric

The invoice ID.

curl -X POST "https://api.sellauth.com/v1/shops/{shopId}/invoices/{invoiceId}/refund" \
  -H "Authorization: Bearer <token>"

Unrefund Invoice

Unmarks an invoice as refunded.

POST
/v1/shops/{shopId}/invoices/{invoiceId}/unrefund

Authorization

AuthorizationRequiredBearer <token>

You can retrieve your API key by visiting your dashboard and clicking Account > API.

In: header

Path Parameters

shopIdRequiredinteger

The shop ID.

invoiceIdRequirednumeric

The invoice ID.

curl -X POST "https://api.sellauth.com/v1/shops/{shopId}/invoices/{invoiceId}/unrefund" \
  -H "Authorization: Bearer <token>"

Reverse Affiliate Commission

Claws back the affiliate commission credited for an invoice (e.g. after a refund or chargeback). The affiliate wallet may go negative; payouts are blocked while it is.

POST
/v1/shops/{shopId}/invoices/{invoiceId}/reverse-affiliate-commission

Authorization

AuthorizationRequiredBearer <token>

You can retrieve your API key by visiting your dashboard and clicking Account > API.

In: header

Path Parameters

shopIdRequiredinteger

The shop ID.

invoiceIdRequirednumeric

The invoice ID.

curl -X POST "https://api.sellauth.com/v1/shops/{shopId}/invoices/{invoiceId}/reverse-affiliate-commission" \
  -H "Authorization: Bearer <token>"

Update Invoice Dashboard Note

Updates the invoice dashboard note.

PUT
/v1/shops/{shopId}/invoices/{invoiceId}/dashboard-note

Authorization

AuthorizationRequiredBearer <token>

You can retrieve your API key by visiting your dashboard and clicking Account > API.

In: header

Path Parameters

shopIdRequiredinteger

The shop ID.

invoiceIdRequirednumeric

The invoice ID.

curl -X PUT "https://api.sellauth.com/v1/shops/{shopId}/invoices/{invoiceId}/dashboard-note" \
  -H "Authorization: Bearer <token>"

Update Paid Amount

Updates the paid amount of an invoice.

PUT
/v1/shops/{shopId}/invoices/{invoiceId}/paid-amount

Authorization

AuthorizationRequiredBearer <token>

You can retrieve your API key by visiting your dashboard and clicking Account > API.

In: header

Request Body

application/jsonRequired
paidRequirednumber

The amount paid in the invoice currency.

paid_usdRequirednumber

The amount paid in USD.

Path Parameters

shopIdRequiredinteger

The shop ID.

invoiceIdRequirednumeric

The invoice ID.

curl -X PUT "https://api.sellauth.com/v1/shops/{shopId}/invoices/{invoiceId}/paid-amount" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "paid": 9.99,
    "paid_usd": 9.99
  }'

POST
/v1/shops/{shopId}/invoices/{invoiceId}/ship

Authorization

AuthorizationRequiredBearer <token>

You can retrieve your API key by visiting your dashboard and clicking Account > API.

In: header

Request Body

application/jsonOptional
tracking_codestring

Must not be greater than 255 characters.

tracking_linkstring

Must not be greater than 2048 characters.

Path Parameters

shopIdRequiredstring
invoiceIdRequiredstring
curl -X POST "https://api.sellauth.com/v1/shops/culpa/invoices/culpa/ship" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "tracking_code": "pasyzwszwtxpeqq",
    "tracking_link": "ikymwkiinfowtzm"
  }'

POST
/v1/shops/{shopId}/invoices/{invoiceId}/deliver

Authorization

AuthorizationRequiredBearer <token>

You can retrieve your API key by visiting your dashboard and clicking Account > API.

In: header

Path Parameters

shopIdRequiredstring
invoiceIdRequiredstring
curl -X POST "https://api.sellauth.com/v1/shops/culpa/invoices/culpa/deliver" \
  -H "Authorization: Bearer <token>"

GET
/v1/shops/{shopId}/invoices/{invoiceId}/pdf

Authorization

AuthorizationRequiredBearer <token>

You can retrieve your API key by visiting your dashboard and clicking Account > API.

In: header

Path Parameters

shopIdRequiredstring
invoiceIdRequiredstring
curl -X GET "https://api.sellauth.com/v1/shops/culpa/invoices/culpa/pdf" \
  -H "Authorization: Bearer <token>"

{
  "message": "Unauthenticated."
}

GET
/v1/shops/{shopId}/invoices/{invoiceId}/email-preview

Authorization

AuthorizationRequiredBearer <token>

You can retrieve your API key by visiting your dashboard and clicking Account > API.

In: header

Path Parameters

shopIdRequiredstring
invoiceIdRequiredstring
curl -X GET "https://api.sellauth.com/v1/shops/culpa/invoices/culpa/email-preview" \
  -H "Authorization: Bearer <token>"

{
  "message": "Unauthenticated."
}

Process Invoice

Processes an invoice.

GET
/v1/shops/{shopId}/invoices/{invoiceId}/process

Authorization

AuthorizationRequiredBearer <token>

You can retrieve your API key by visiting your dashboard and clicking Account > API.

In: header

Path Parameters

shopIdRequiredinteger

The shop ID.

invoiceIdRequirednumeric

The invoice ID.

curl -X GET "https://api.sellauth.com/v1/shops/{shopId}/invoices/{invoiceId}/process" \
  -H "Authorization: Bearer <token>"

{
  "message": "Unauthenticated."
}

Replace Delivered

Replaces the delivered items of an invoice.

POST
/v1/shops/{shopId}/invoices/{invoiceId}/replace-delivered

Authorization

AuthorizationRequiredBearer <token>

You can retrieve your API key by visiting your dashboard and clicking Account > API.

In: header

Request Body

application/jsonRequired
invoice_item_idRequiredinteger
replacementsRequiredobject

Path Parameters

shopIdRequiredinteger

The shop ID.

invoiceIdRequirednumeric

The invoice ID.

curl -X POST "https://api.sellauth.com/v1/shops/{shopId}/invoices/{invoiceId}/replace-delivered" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "invoice_item_id": 12,
    "replacements": []
  }'

Redo Dynamic Delivery

Calls the dynamic delivery endpoint for an invoice item again.

POST
/v1/shops/{shopId}/invoices/{invoiceId}/redo-dynamic-delivery

Authorization

AuthorizationRequiredBearer <token>

You can retrieve your API key by visiting your dashboard and clicking Account > API.

In: header

Request Body

application/jsonRequired
invoice_item_idRequiredinteger

Path Parameters

shopIdRequiredinteger

The shop ID.

invoiceIdRequirednumeric

The invoice ID.

curl -X POST "https://api.sellauth.com/v1/shops/{shopId}/invoices/{invoiceId}/redo-dynamic-delivery" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "invoice_item_id": 12
  }'

POST
/v1/shops/{shopId}/invoices/{invoiceId}/resend-email

Authorization

AuthorizationRequiredBearer <token>

You can retrieve your API key by visiting your dashboard and clicking Account > API.

In: header

Request Body

application/jsonOptional
emailstring

Must be a valid email address. Must not be greater than 255 characters.

Path Parameters

shopIdRequiredstring
invoiceIdRequiredstring
curl -X POST "https://api.sellauth.com/v1/shops/culpa/invoices/culpa/resend-email" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "morgan93@example.net"
  }'

Images

Notifications