Skip to main content

Get RMA Dropship Credit

GET 

/api/rmas/:rma/dropship-credit

Get the SUGGESTED credit breakdown of an RMA raised against a dropship-for-customer order (an order you shipped directly to a B2B retailer's consumer). Advisory only: this does not create or change a sales credit — issue the credit note yourself at the suggested amount.

Required scope: returns:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Authentication: Requires Bearer token. Scope: returns (read).

Path parameters:

  • rma (integer, required): RMA ID.

data is null when the RMA is not for a dropship-for-customer order.

Response data:

  • goods (number): value of the RMA's expected lines at the sales order line prices.
  • restocking_fee_percent (number): the retailer's restocking fee percentage from its dropship terms.
  • restocking_fee (number): goods x restocking_fee_percent / 100, rounded to 2 decimals.
  • refund_dropship_fee (boolean): whether the suggested credit includes the per-order dropship fee charged on the sales order. Off by default.
  • dropship_fee_refund (number): the dropship fee included in the suggestion (0 when refund_dropship_fee is false).
  • net_credit (number): goods - restocking_fee + dropship_fee_refund — the suggested credit amount (not applied to any sales credit).

Errors: 404 when the RMA does not exist.

Request​

Responses​

OK

Response Headers
    Content-Type