docs: update API reference for the loyalty plugin

Author: shahednasser

www/apps/api-reference/specs/admin/code_samples/Shell/admin_gift-cards_{id}_redeem/post.sh

@@ -0,0 +1,6 @@
+curl -X POST '{backend_url}/admin/store-credit-accounts/{id}/credit' \
+-H 'Authorization: Bearer {access_token}' \
+-H 'Content-Type: application/json' \
+--data-raw '{
+  "amount": 0
+}'

www/apps/api-reference/specs/admin/code_samples/Shell/admin_store-credit-accounts_{id}_credit/post.sh

@@ -3,7 +3,6 @@ description: The details of the store credit account to create.
 x-schemaName: AdminCreateStoreCreditAccount
 required:
   - currency_code
-  - customer_id
 properties:
   currency_code:
     type: string

www/apps/api-reference/specs/admin/code_samples/Shell/admin_transaction-groups/get.sh

@@ -0,0 +1,14 @@
+type: object
+description: The details of the credits to add to the store credit account.
+x-schemaName: AdminCreditStoreCreditAccountParams
+required:
+  - amount
+properties:
+  amount:
+    type: number
+    title: amount
+    description: The credits to add to the store credit account.
+  note:
+    type: string
+    title: note
+    description: An internal note with more details on the credit addition.

www/apps/api-reference/specs/admin/components/schemas/AdminCreateStoreCreditAccount.yaml

@@ -3,9 +3,7 @@ description: The store credit account's details.
 x-schemaName: AdminStoreCreditAccount
 required:
   - customer
-  - transaction_groups
   - id
-  - customer_id
   - currency_code
   - credits
   - debits
@@ -41,11 +39,6 @@ properties:
     type: number
     title: balance
     description: The account's balance.
-  transaction_groups:
-    type: array
-    description: The store credit account's transaction groups.
-    items:
-      $ref: ./AdminTransactionGroup.yaml
   metadata:
     type: object
     description: The store credit account's metadata, can hold custom key-value pairs.
@@ -62,3 +55,7 @@ properties:
     format: date-time
     title: updated_at
     description: The date the store credit account was updated at.
+  code:
+    type: string
+    title: code
+    description: The store credit account's code.

www/apps/api-reference/specs/admin/components/schemas/AdminCreditStoreCreditAccountParams.yaml

@@ -5,7 +5,6 @@ required:
   - account
   - id
   - account_id
-  - transaction_group_id
   - type
   - amount
   - metadata
@@ -20,10 +19,6 @@ properties:
     type: string
     title: account_id
     description: The ID of the store credit account that the transaction belongs to.
-  transaction_group_id:
-    type: string
-    title: transaction_group_id
-    description: The ID of the transaction group that the transaction belongs to.
   type:
     type: string
     description: The transaction's type.

www/apps/api-reference/specs/admin/components/schemas/AdminRedeemGiftCard.yaml

@@ -0,0 +1,10 @@
+type: object
+description: The details of claiming the credit.
+x-schemaName: StoreClaimStoreCreditAccountParams
+required:
+  - code
+properties:
+  code:
+    type: string
+    title: code
+    description: The code of the store credit account to claim.