Files
medusa-store/docs/content/references/services/classes/PaymentProviderService.md
2022-06-01 18:33:08 +02:00

498 lines
9.6 KiB
Markdown

# Class: PaymentProviderService
Helps retrive payment providers
## Hierarchy
- `"medusa-interfaces"`
**`PaymentProviderService`**
## Constructors
### constructor
**new PaymentProviderService**(`container`)
#### Parameters
| Name | Type |
| :------ | :------ |
| `container` | `any` |
#### Overrides
BaseService.constructor
#### Defined in
[services/payment-provider.js:8](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/payment-provider.js#L8)
## Properties
### manager\_
**manager\_**: `any`
#### Defined in
[services/payment-provider.js:14](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/payment-provider.js#L14)
___
### paymentRepository\_
**paymentRepository\_**: `any`
#### Defined in
[services/payment-provider.js:18](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/payment-provider.js#L18)
___
### paymentSessionRepository\_
**paymentSessionRepository\_**: `any`
#### Defined in
[services/payment-provider.js:16](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/payment-provider.js#L16)
___
### refundRepository\_
**refundRepository\_**: `any`
#### Defined in
[services/payment-provider.js:20](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/payment-provider.js#L20)
## Methods
### authorizePayment
**authorizePayment**(`paymentSession`, `context`): `Promise`<`any`\>
#### Parameters
| Name | Type |
| :------ | :------ |
| `paymentSession` | `any` |
| `context` | `any` |
#### Returns
`Promise`<`any`\>
#### Defined in
[services/payment-provider.js:283](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/payment-provider.js#L283)
___
### cancelPayment
**cancelPayment**(`paymentObj`): `Promise`<`any`\>
#### Parameters
| Name | Type |
| :------ | :------ |
| `paymentObj` | `any` |
#### Returns
`Promise`<`any`\>
#### Defined in
[services/payment-provider.js:324](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/payment-provider.js#L324)
___
### capturePayment
**capturePayment**(`paymentObj`): `Promise`<`any`\>
#### Parameters
| Name | Type |
| :------ | :------ |
| `paymentObj` | `any` |
#### Returns
`Promise`<`any`\>
#### Defined in
[services/payment-provider.js:343](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/payment-provider.js#L343)
___
### createPayment
**createPayment**(`cart`): `Promise`<`any`\>
#### Parameters
| Name | Type |
| :------ | :------ |
| `cart` | `any` |
#### Returns
`Promise`<`any`\>
#### Defined in
[services/payment-provider.js:246](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/payment-provider.js#L246)
___
### createSession
**createSession**(`providerId`, `cart`): `Promise`<`any`\>
Creates a payment session with the given provider.
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `providerId` | `string` | the id of the provider to create payment with |
| `cart` | `Cart` | a cart object used to calculate the amount, etc. from |
#### Returns
`Promise`<`any`\>
the payment session
#### Defined in
[services/payment-provider.js:121](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/payment-provider.js#L121)
___
### deleteSession
**deleteSession**(`paymentSession`): `any`
#### Parameters
| Name | Type |
| :------ | :------ |
| `paymentSession` | `any` |
#### Returns
`any`
#### Defined in
[services/payment-provider.js:202](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/payment-provider.js#L202)
___
### getStatus
**getStatus**(`payment`): `Promise`<`any`\>
#### Parameters
| Name | Type |
| :------ | :------ |
| `payment` | `any` |
#### Returns
`Promise`<`any`\>
#### Defined in
[services/payment-provider.js:338](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/payment-provider.js#L338)
___
### list
**list**(): `Promise`<`any`\>
#### Returns
`Promise`<`any`\>
#### Defined in
[services/payment-provider.js:47](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/payment-provider.js#L47)
___
### listPayments
**listPayments**(`selector`, `config?`): `any`
#### Parameters
| Name | Type | Default value |
| :------ | :------ | :------ |
| `selector` | `any` | `undefined` |
| `config` | `Object` | `undefined` |
| `config.order` | `Object` | `undefined` |
| `config.order.created_at` | `string` | `"DESC"` |
| `config.skip` | `number` | `0` |
| `config.take` | `number` | `50` |
#### Returns
`any`
#### Defined in
[services/payment-provider.js:80](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/payment-provider.js#L80)
___
### refreshSession
**refreshSession**(`paymentSession`, `cart`): `Promise`<`any`\>
Refreshes a payment session with the given provider.
This means, that we delete the current one and create a new.
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `paymentSession` | `PaymentSession` | the payment session object to update |
| `cart` | `Cart` | a cart object used to calculate the amount, etc. from |
#### Returns
`Promise`<`any`\>
the payment session
#### Defined in
[services/payment-provider.js:152](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/payment-provider.js#L152)
___
### refundPayment
**refundPayment**(`payObjs`, `amount`, `reason`, `note`): `Promise`<`any`\>
#### Parameters
| Name | Type |
| :------ | :------ |
| `payObjs` | `any` |
| `amount` | `any` |
| `reason` | `any` |
| `note` | `any` |
#### Returns
`Promise`<`any`\>
#### Defined in
[services/payment-provider.js:358](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/payment-provider.js#L358)
___
### registerInstalledProviders
**registerInstalledProviders**(`providers`): `Promise`<`void`\>
#### Parameters
| Name | Type |
| :------ | :------ |
| `providers` | `any` |
#### Returns
`Promise`<`void`\>
#### Defined in
[services/payment-provider.js:35](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/payment-provider.js#L35)
___
### retrievePayment
**retrievePayment**(`id`, `relations?`): `Promise`<`any`\>
#### Parameters
| Name | Type | Default value |
| :------ | :------ | :------ |
| `id` | `any` | `undefined` |
| `relations` | `any`[] | `[]` |
#### Returns
`Promise`<`any`\>
#### Defined in
[services/payment-provider.js:54](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/payment-provider.js#L54)
___
### retrieveProvider
**retrieveProvider**(`providerId`): `PaymentService`
Finds a provider given an id
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `providerId` | `string` | the id of the provider to get |
#### Returns
`PaymentService`
the payment provider
#### Defined in
[services/payment-provider.js:228](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/payment-provider.js#L228)
___
### retrieveRefund
**retrieveRefund**(`id`, `config?`): `Promise`<`any`\>
#### Parameters
| Name | Type |
| :------ | :------ |
| `id` | `any` |
| `config` | `Object` |
#### Returns
`Promise`<`any`\>
#### Defined in
[services/payment-provider.js:422](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/payment-provider.js#L422)
___
### retrieveSession
**retrieveSession**(`id`, `relations?`): `Promise`<`any`\>
#### Parameters
| Name | Type | Default value |
| :------ | :------ | :------ |
| `id` | `any` | `undefined` |
| `relations` | `any`[] | `[]` |
#### Returns
`Promise`<`any`\>
#### Defined in
[services/payment-provider.js:89](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/payment-provider.js#L89)
___
### updatePayment
**updatePayment**(`paymentId`, `update`): `Promise`<`any`\>
#### Parameters
| Name | Type |
| :------ | :------ |
| `paymentId` | `any` |
| `update` | `any` |
#### Returns
`Promise`<`any`\>
#### Defined in
[services/payment-provider.js:266](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/payment-provider.js#L266)
___
### updateSession
**updateSession**(`paymentSession`, `cart`): `Promise`<`any`\>
Updates an existing payment session.
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `paymentSession` | `PaymentSession` | the payment session object to update |
| `cart` | `Cart` | the cart object to update for |
#### Returns
`Promise`<`any`\>
the updated payment session
#### Defined in
[services/payment-provider.js:188](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/payment-provider.js#L188)
___
### updateSessionData
**updateSessionData**(`paySession`, `update`): `Promise`<`any`\>
#### Parameters
| Name | Type |
| :------ | :------ |
| `paySession` | `any` |
| `update` | `any` |
#### Returns
`Promise`<`any`\>
#### Defined in
[services/payment-provider.js:308](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/payment-provider.js#L308)
___
### withTransaction
**withTransaction**(`manager`): [`PaymentProviderService`](PaymentProviderService.md)
#### Parameters
| Name | Type |
| :------ | :------ |
| `manager` | `any` |
#### Returns
[`PaymentProviderService`](PaymentProviderService.md)
#### Defined in
[services/payment-provider.js:23](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/payment-provider.js#L23)