fa7c94b4cc
* docs: migrate ui docs to docs universe * created yarn workspace * added eslint and tsconfig configurations * fix eslint configurations * fixed eslint configurations * shared tailwind configurations * added shared ui package * added more shared components * migrating more components * made details components shared * move InlineCode component * moved InputText * moved Loading component * Moved Modal component * moved Select components * Moved Tooltip component * moved Search components * moved ColorMode provider * Moved Notification components and providers * used icons package * use UI colors in api-reference * moved Navbar component * used Navbar and Search in UI docs * added Feedback to UI docs * general enhancements * fix color mode * added copy colors file from ui-preset * added features and enhancements to UI docs * move Sidebar component and provider * general fixes and preparations for deployment * update docusaurus version * adjusted versions * fix output directory * remove rootDirectory property * fix yarn.lock * moved code component * added vale for all docs MD and MDX * fix tests * fix vale error * fix deployment errors * change ignore commands * add output directory * fix docs test * general fixes * content fixes * fix announcement script * added changeset * fix vale checks * added nofilter option * fix vale error
91 lines
2.5 KiB
YAML
91 lines
2.5 KiB
YAML
title: Refund
|
|
description: >-
|
|
A refund represents an amount of money transfered back to the customer for a
|
|
given reason. Refunds may occur in relation to Returns, Swaps and Claims, but
|
|
can also be initiated by an admin for an order.
|
|
type: object
|
|
required:
|
|
- amount
|
|
- created_at
|
|
- id
|
|
- idempotency_key
|
|
- metadata
|
|
- note
|
|
- order_id
|
|
- payment_id
|
|
- reason
|
|
- updated_at
|
|
properties:
|
|
id:
|
|
description: The refund's ID
|
|
type: string
|
|
example: ref_01G1G5V27GYX4QXNARRQCW1N8T
|
|
order_id:
|
|
description: The ID of the order this refund was created for.
|
|
nullable: true
|
|
type: string
|
|
example: order_01G8TJSYT9M6AVS5N4EMNFS1EK
|
|
order:
|
|
description: The details of the order this refund was created for.
|
|
x-expandable: order
|
|
nullable: true
|
|
type: object
|
|
payment_id:
|
|
description: The payment's ID, if available.
|
|
nullable: true
|
|
type: string
|
|
example: pay_01G8ZCC5W42ZNY842124G7P5R9
|
|
payment:
|
|
description: The details of the payment associated with the refund.
|
|
x-expandable: payment
|
|
nullable: true
|
|
type: object
|
|
amount:
|
|
description: The amount that has be refunded to the Customer.
|
|
type: integer
|
|
example: 1000
|
|
note:
|
|
description: An optional note explaining why the amount was refunded.
|
|
nullable: true
|
|
type: string
|
|
example: I didn't like it
|
|
reason:
|
|
description: >-
|
|
The reason given for the Refund, will automatically be set when processed
|
|
as part of a Swap, Claim or Return.
|
|
type: string
|
|
enum:
|
|
- discount
|
|
- return
|
|
- swap
|
|
- claim
|
|
- other
|
|
example: return
|
|
idempotency_key:
|
|
description: >-
|
|
Randomly generated key used to continue the completion of the refund in
|
|
case of failure.
|
|
nullable: true
|
|
type: string
|
|
externalDocs:
|
|
url: https://docs.medusajs.com/development/idempotency-key/overview.md
|
|
description: Learn more how to use the idempotency key.
|
|
created_at:
|
|
description: The date with timezone at which the resource was created.
|
|
type: string
|
|
format: date-time
|
|
updated_at:
|
|
description: The date with timezone at which the resource was updated.
|
|
type: string
|
|
format: date-time
|
|
metadata:
|
|
description: An optional key-value map with additional details
|
|
nullable: true
|
|
type: object
|
|
example:
|
|
car: white
|
|
externalDocs:
|
|
description: Learn about the metadata attribute, and how to delete and update it.
|
|
url: >-
|
|
https://docs.medusajs.com/development/entities/overview#metadata-attribute
|