Skip to content

payment_method_api.md

Latest commit

 

History

History
89 lines (58 loc) · 3.53 KB

payment_method_api.md

File metadata and controls

89 lines (58 loc) · 3.53 KB
Raw
description Use PHP API and REST API to manage payment methods in Commerce. You can create, modify and delete payment methods.
edition commerce

Payment method API

!!! tip "Order management REST API"

To learn how to manage payment methods with the REST API, see the [REST API reference](/api/rest_api/rest_api_reference/rest_api_reference.html#tag/Payments).

To get payment methods and manage them, use the Ibexa\Contracts\Payment\PaymentMethodServiceInterface interface.

From the developer's perspective, payment methods are referenced with identifiers defined manually at method creation stage in user interface.

!!! note "Support for multilingual applications"

The `getPaymentMethodByIdentifier`, `getPaymentMethod` and `findPaymentMethods` methods take a second argument, `$prioritizedLanguages`, that can be an array of language codes or `null`.
If there are language codes in an array, methods return payment method name translations in the specified languages.
Translations come from the database.

Get single payment method

Get single payment method by identifier

To access a single payment method by using its string identifier, use the PaymentMethodService::getPaymentMethodByIdentifier method:

[[= include_file('code_samples/api/commerce/src/Command/PaymentMethodCommand.php', 56, 60) =]]

Get single payment method by ID

To access a single payment method by using its numerical ID, use the PaymentMethodService::getPaymentMethod method:

[[= include_file('code_samples/api/commerce/src/Command/PaymentMethodCommand.php', 50, 54) =]]

Get multiple payment methods

To fetch multiple payment methods, use the PaymentMethodService::findPaymentMethods method.

It follows the same search query pattern as other APIs:

[[= include_file('code_samples/api/commerce/src/Command/PaymentMethodCommand.php', 62, 79) =]]

Create payment method

To create a payment method, use the PaymentMethodService::createPaymentMethod method and provide it with an Ibexa\Contracts\Payment\PaymentMethod\PaymentMethodCreateStruct object that takes the following parameters:

  • identifier string
  • type TypeInterface object
  • names array of string values
  • descriptions array of string values
  • enabled boolean value
  • options object.
[[= include_file('code_samples/api/commerce/src/Command/PaymentMethodCommand.php', 62, 63) =]][[= include_file('code_samples/api/commerce/src/Command/PaymentMethodCommand.php', 81, 91) =]]

Update payment method

You can update the payment method after it's created. An Ibexa\Contracts\Payment\PaymentMethod\PaymentMethodUpdateStruct object can take the following arguments: identifier string, names array of string values, descriptions array of string values, enabled boolean value, and an options object.

To update payment method information, use the PaymentMethodServiceInterface::updatePaymentMethod method:

[[= include_file('code_samples/api/commerce/src/Command/PaymentMethodCommand.php', 93, 103) =]]

Delete payment method

To delete a payment method from the system, use the PaymentMethodService::deletePayment method:

[[= include_file('code_samples/api/commerce/src/Command/PaymentMethodCommand.php', 105, 111) =]]

Check whether payment method is used

To check whether a payment method is used, for example, before you delete it, use the PaymentMethodService::isPaymentMethodUsed method:

[[= include_file('code_samples/api/commerce/src/Command/PaymentMethodCommand.php', 113, 126) =]]