medusa-store/docs/content/references/services/classes/PaymentCollectionService.md

Class: PaymentCollectionService

Hierarchy

• TransactionBaseService

  ↳ PaymentCollectionService

Constructors

constructor

• new PaymentCollectionService(__namedParameters)

Parameters

Name	Type
__namedParameters	InjectedDependencies

Overrides

TransactionBaseService.constructor

Defined in

packages/medusa/src/services/payment-collection.ts:52

Properties

__configModule__

• Protected Optional Readonly __configModule__: Record<string, unknown>

Inherited from

TransactionBaseService.__configModule__

Defined in

packages/medusa/src/interfaces/transaction-base-service.ts:10

---

__container__

• Protected Readonly __container__: any

Inherited from

TransactionBaseService.__container__

Defined in

packages/medusa/src/interfaces/transaction-base-service.ts:9

---

customerService_

• Protected Readonly customerService_: CustomerService

Defined in

packages/medusa/src/services/payment-collection.ts:48

---

eventBusService_

• Protected Readonly eventBusService_: EventBusService

Defined in

packages/medusa/src/services/payment-collection.ts:46

---

manager_

• Protected Readonly manager_: EntityManager

Overrides

TransactionBaseService.manager_

Defined in

packages/medusa/src/services/payment-collection.ts:44

---

paymentCollectionRepository_

• Protected Readonly paymentCollectionRepository_: typeof PaymentCollectionRepository

Defined in

packages/medusa/src/services/payment-collection.ts:50

---

paymentProviderService_

• Protected Readonly paymentProviderService_: PaymentProviderService

Defined in

packages/medusa/src/services/payment-collection.ts:47

---

transactionManager_

• Protected transactionManager_: undefined | EntityManager

Overrides

TransactionBaseService.transactionManager_

Defined in

packages/medusa/src/services/payment-collection.ts:45

---

Events

▪ Static Readonly Events: Object

Type declaration

Name	Type
CREATED	string
DELETED	string
PAYMENT_AUTHORIZED	string
UPDATED	string

Defined in

packages/medusa/src/services/payment-collection.ts:37

Methods

atomicPhase_

▸ Protected atomicPhase_<TResult, TError>(work, isolationOrErrorHandler?, maybeErrorHandlerOrDontFail?): Promise<TResult>

Wraps some work within a transactional block. If the service already has a transaction manager attached this will be reused, otherwise a new transaction manager is created.

Type parameters

Name
TResult
TError

Parameters

Name	Type	Description
work	(transactionManager: EntityManager) => Promise<TResult>	the transactional work to be done
isolationOrErrorHandler?	IsolationLevel | (error: TError) => Promise<void | TResult>	the isolation level to be used for the work.
maybeErrorHandlerOrDontFail?	(error: TError) => Promise<void | TResult>	Potential error handler

Returns

Promise<TResult>

the result of the transactional work

Inherited from

TransactionBaseService.atomicPhase_

Defined in

packages/medusa/src/interfaces/transaction-base-service.ts:48

---

authorize

▸ authorize(paymentCollectionId, context?): Promise<PaymentCollection>

Parameters

Name	Type
paymentCollectionId	string
context	Record<string, unknown>

Returns

Promise<PaymentCollection>

Defined in

packages/medusa/src/services/payment-collection.ts:390

---

create

▸ create(data): Promise<PaymentCollection>

Parameters

Name	Type
data	CreatePaymentCollectionInput

Returns

Promise<PaymentCollection>

Defined in

packages/medusa/src/services/payment-collection.ts:92

---

delete

▸ delete(paymentCollectionId): Promise<undefined | PaymentCollection>

Parameters

Name	Type
paymentCollectionId	string

Returns

Promise<undefined | PaymentCollection>

Defined in

packages/medusa/src/services/payment-collection.ts:150

---

isValidTotalAmount

▸ Private isValidTotalAmount(total, sessionsInput): boolean

Parameters

Name	Type
total	number
sessionsInput	PaymentCollectionSessionInput[]

Returns

boolean

Defined in

packages/medusa/src/services/payment-collection.ts:188

---

markAsAuthorized

▸ markAsAuthorized(paymentCollectionId): Promise<PaymentCollection>

Parameters

Name	Type
paymentCollectionId	string

Returns

Promise<PaymentCollection>

Defined in

packages/medusa/src/services/payment-collection.ts:368

---

refreshPaymentSession

▸ refreshPaymentSession(paymentCollectionId, sessionId, sessionInput): Promise<PaymentSession>

Parameters

Name	Type
paymentCollectionId	string
sessionId	string
sessionInput	Omit<PaymentCollectionSessionInput, "amount">

Returns

Promise<PaymentSession>

Defined in

packages/medusa/src/services/payment-collection.ts:293

---

retrieve

▸ retrieve(paymentCollectionId, config?): Promise<PaymentCollection>

Parameters

Name	Type
paymentCollectionId	string
config	FindConfig<PaymentCollection>

Returns

Promise<PaymentCollection>

Defined in

packages/medusa/src/services/payment-collection.ts:69

---

setPaymentSessions

▸ setPaymentSessions(paymentCollectionId, sessions): Promise<PaymentCollection>

Parameters

Name	Type
paymentCollectionId	string
sessions	PaymentCollectionSessionInput | PaymentCollectionSessionInput[]

Returns

Promise<PaymentCollection>

Defined in

packages/medusa/src/services/payment-collection.ts:196

---

shouldRetryTransaction_

▸ Protected shouldRetryTransaction_(err): boolean

Parameters

Name	Type
err	Record<string, unknown> | { code: string }

Returns

boolean

Inherited from

TransactionBaseService.shouldRetryTransaction_

Defined in

packages/medusa/src/interfaces/transaction-base-service.ts:29

---

update

▸ update(paymentCollectionId, data): Promise<PaymentCollection>

Parameters

Name	Type
paymentCollectionId	string
data	Object
data.amount?	number
data.authorized_amount?	null | number
data.created_at?	{ toString?: {} | undefined; toDateString?: {} | undefined; toTimeString?: {} | undefined; toLocaleString?: {} | undefined; toLocaleDateString?: {} | undefined; toLocaleTimeString?: {} | undefined; ... 37 more ...; [Symbol.toPrimitive]?: {} | undefined; }
data.created_by?	string
data.currency?	{ code?: string | undefined; symbol?: string | undefined; symbol_native?: string | undefined; name?: string | undefined; includes_tax?: boolean | undefined; }
data.currency_code?	string
data.deleted_at?	null | { toString?: {} | undefined; toDateString?: {} | undefined; toTimeString?: {} | undefined; toLocaleString?: {} | undefined; toLocaleDateString?: {} | undefined; toLocaleTimeString?: {} | undefined; ... 37 more ...; [Symbol.toPrimitive]?: {} | undefined; }
data.description?	null | string
data.id?	string
data.metadata?	{ [x: string]: unknown; }
data.payment_sessions?	(undefined | { cart_id?: string | undefined; cart?: { readonly object?: "cart" | undefined; email?: string | undefined; billing_address_id?: string | undefined; billing_address?: { customer_id?: string | ... 1 more ... | undefined; ... 16 more ...; updated_at?: { ...; } | undefined; } | undefined; ... 36 more ...; updated_at?: {...)[]
data.payments?	(undefined | { swap_id?: string | undefined; swap?: { fulfillment_status?: SwapFulfillmentStatus | undefined; payment_status?: SwapPaymentStatus | undefined; ... 21 more ...; updated_at?: { ...; } | undefined; } | undefined; ... 16 more ...; updated_at?: { ...; } | undefined; })[]
data.region?	{ name?: string | undefined; currency_code?: string | undefined; currency?: { code?: string | undefined; symbol?: string | undefined; symbol_native?: string | undefined; name?: string | undefined; includes_tax?: boolean | undefined; } | undefined; ... 15 more ...; updated_at?: { ...; } | undefined; }
data.region_id?	string
data.status?	PaymentCollectionStatus
data.type?	ORDER_EDIT
data.updated_at?	{ toString?: {} | undefined; toDateString?: {} | undefined; toTimeString?: {} | undefined; toLocaleString?: {} | undefined; toLocaleDateString?: {} | undefined; toLocaleTimeString?: {} | undefined; ... 37 more ...; [Symbol.toPrimitive]?: {} | undefined; }

Returns

Promise<PaymentCollection>

Defined in

packages/medusa/src/services/payment-collection.ts:121

---

withTransaction

▸ withTransaction(transactionManager?): PaymentCollectionService

Parameters

Name	Type
transactionManager?	EntityManager

Returns

PaymentCollectionService

Inherited from

TransactionBaseService.withTransaction

Defined in

packages/medusa/src/interfaces/transaction-base-service.ts:13