feat(core-flows,payment,medusa,types): Refund reasons management API (#8436)

* feat(core-flows,payment,medusa,types): add ability to set and manage refund reasons

* fix(payment): validate total amount when refunding payment (#8437)

Co-authored-by: Carlos R. L. Rodrigues <37986729+carlos-r-l-rodrigues@users.noreply.github.com>

* feature: introduce additional_data to the product endpoints (#8405)

* chore(docs): Generated References (#8440)

Generated the following references:
- `product`

* chore: align payment database schema

* Update packages/core/core-flows/src/payment-collection/steps/create-refund-reasons.ts

Co-authored-by: Oli Juhl <59018053+olivermrbl@users.noreply.github.com>

* chore: address review

---------

Co-authored-by: Carlos R. L. Rodrigues <37986729+carlos-r-l-rodrigues@users.noreply.github.com>
Co-authored-by: Harminder Virk <virk.officials@gmail.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Oli Juhl <59018053+olivermrbl@users.noreply.github.com>

packages/modules/payment/src/models/capture.ts

@@ -37,6 +37,9 @@ export default class Capture {
   })
   payment!: Payment
 
+  @Property({ columnType: "jsonb", nullable: true })
+  metadata: Record<string, unknown> | null = null
+
   @Property({
     onCreate: () => new Date(),
     columnType: "timestamptz",

packages/modules/payment/src/models/index.ts

@@ -5,3 +5,4 @@ export { default as PaymentMethodToken } from "./payment-method-token"
 export { default as PaymentProvider } from "./payment-provider"
 export { default as PaymentSession } from "./payment-session"
 export { default as Refund } from "./refund"
+export { default as RefundReason } from "./refund-reason"

packages/modules/payment/src/models/payment-method-token.ts

@@ -45,7 +45,7 @@ export default class PaymentMethodToken {
   @Property({
     columnType: "timestamptz",
     nullable: true,
-    index: "IDX_payment_metod_token_deleted_at",
+    index: "IDX_payment_method_token_deleted_at",
   })
   deleted_at: Date | null = null
 

packages/modules/payment/src/models/payment-session.ts

@@ -79,6 +79,9 @@ export default class PaymentSession {
   })
   payment?: Rel<Payment> | null
 
+  @Property({ columnType: "jsonb", nullable: true })
+  metadata: Record<string, unknown> | null = null
+
   @Property({
     onCreate: () => new Date(),
     columnType: "timestamptz",

packages/modules/payment/src/models/payment.ts

@@ -4,6 +4,7 @@ import {
   DALUtils,
   MikroOrmBigNumberProperty,
   Searchable,
+  createPsqlIndexStatementHelper,
   generateEntityId,
 } from "@medusajs/utils"
 import {
@@ -28,7 +29,13 @@ import Refund from "./refund"
 
 type OptionalPaymentProps = DAL.ModelDateColumns
 
-@Entity({ tableName: "payment" })
+const tableName = "payment"
+const ProviderIdIndex = createPsqlIndexStatementHelper({
+  tableName,
+  columns: "provider_id",
+})
+
+@Entity({ tableName })
 @Filter(DALUtils.mikroOrmSoftDeletableFilterOptions)
 export default class Payment {
   [OptionalProps]?: OptionalPaymentProps
@@ -46,6 +53,7 @@ export default class Payment {
   currency_code: string
 
   @Property({ columnType: "text" })
+  @ProviderIdIndex.MikroORMIndex()
   provider_id: string
 
   @Searchable()

packages/modules/payment/src/models/refund-reason.ts

@@ -0,0 +1,54 @@
+import { DALUtils, generateEntityId, Searchable } from "@medusajs/utils"
+import {
+  BeforeCreate,
+  Entity,
+  Filter,
+  OnInit,
+  PrimaryKey,
+  Property,
+} from "@mikro-orm/core"
+
+@Entity({ tableName: "refund_reason" })
+@Filter(DALUtils.mikroOrmSoftDeletableFilterOptions)
+export default class RefundReason {
+  @PrimaryKey({ columnType: "text" })
+  id: string
+
+  @Searchable()
+  @Property({ columnType: "text" })
+  label: string
+
+  @Property({ columnType: "text", nullable: true })
+  description: string | null = null
+
+  @Property({ columnType: "jsonb", nullable: true })
+  metadata: Record<string, unknown> | null = null
+
+  @Property({
+    onCreate: () => new Date(),
+    columnType: "timestamptz",
+    defaultRaw: "now()",
+  })
+  created_at: Date
+
+  @Property({
+    onCreate: () => new Date(),
+    onUpdate: () => new Date(),
+    columnType: "timestamptz",
+    defaultRaw: "now()",
+  })
+  updated_at: Date
+
+  @Property({ columnType: "timestamptz", nullable: true })
+  deleted_at: Date | null = null
+
+  @BeforeCreate()
+  onCreate() {
+    this.id = generateEntityId(this.id, "refr")
+  }
+
+  @OnInit()
+  onInit() {
+    this.id = generateEntityId(this.id, "refr")
+  }
+}

packages/modules/payment/src/models/refund.ts

@@ -1,4 +1,4 @@
-import { BigNumberRawValue } from "@medusajs/types"
+import { BigNumberRawValue, DAL } from "@medusajs/types"
 import {
   BigNumber,
   MikroOrmBigNumberProperty,
@@ -9,14 +9,24 @@ import {
   Entity,
   ManyToOne,
   OnInit,
+  OptionalProps,
   PrimaryKey,
   Property,
   Rel,
 } from "@mikro-orm/core"
 import Payment from "./payment"
+import RefundReason from "./refund-reason"
+
+type OptionalProps =
+  | "note"
+  | "refund_reason_id"
+  | "refund_reason"
+  | DAL.ModelDateColumns
 
 @Entity({ tableName: "refund" })
 export default class Refund {
+  [OptionalProps]?: OptionalProps
+
   @PrimaryKey({ columnType: "text" })
   id: string
 
@@ -36,6 +46,20 @@ export default class Refund {
   @Property({ columnType: "text", nullable: true })
   payment_id: string
 
+  @ManyToOne(() => RefundReason, {
+    columnType: "text",
+    mapToPk: true,
+    fieldName: "refund_reason_id",
+    nullable: true,
+  })
+  refund_reason_id: string | null = null
+
+  @ManyToOne(() => RefundReason, { persist: false, nullable: true })
+  refund_reason: Rel<RefundReason> | null = null
+
+  @Property({ columnType: "text", nullable: true })
+  note: string | null = null
+
   @Property({
     onCreate: () => new Date(),
     columnType: "timestamptz",
@@ -66,10 +90,12 @@ export default class Refund {
   @BeforeCreate()
   onCreate() {
     this.id = generateEntityId(this.id, "ref")
+    this.refund_reason_id ??= this.refund_reason?.id || null
   }
 
   @OnInit()
   onInit() {
     this.id = generateEntityId(this.id, "ref")
+    this.refund_reason_id ??= this.refund_reason?.id || null
   }
 }