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.
returns:readGrant 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
- 200
- 401
- 403
- 404
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not Found
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.