The Payment Provider Gateway documentation uses the Magento 2.3 (now Adobe Commerce and Magento Open Source) of the Braintree module as a reference application. The Braintree module was removed in version 2.4.0. The concepts described in this guide are still applicable to version 2.4.x, but the code samples are not supported.
Add a payment action
For each payment action available for the payment method, you must implement the following:
Creating a request with payment details. Described in Get payment information from frontend to backend.
Request processing using response handler and response validator.
Specify and configure the gateway command. Described in the Gateway Command topic.
Add the command to the commands pool, as described in Command Pool.
Configure the command
The gateway command for the payment action must be configured in the di.xml file of your module. Conventionally, its location must be <your_module_dir>/etc/di.xml
Configure the command as described in Gateway Command.
Example: authorize payment action for Braintree
Configuring the gateway command and adding it to command pool (app/code/Magento/Braintree/etc/di.xml):
Copied to your clipboard<virtualType name="BraintreeCommandPool" type="Magento\Payment\Gateway\Command\CommandPool"><arguments><argument name="commands" xsi:type="array"><item name="authorize" xsi:type="string">BraintreeAuthorizeCommand</item></argument></arguments></virtualType><virtualType name="BraintreeAuthorizeCommand" type="Magento\Payment\Gateway\Command\GatewayCommand"><arguments><argument name="requestBuilder" xsi:type="object">BraintreeAuthorizeRequest</argument><argument name="transferFactory" xsi:type="object">Magento\Braintree\Gateway\Http\TransferFactory</argument><argument name="client" xsi:type="object">Magento\Braintree\Gateway\Http\Client\TransactionSale</argument><argument name="handler" xsi:type="object">BraintreeAuthorizationHandler</argument><argument name="validator" xsi:type="object">Magento\Braintree\Gateway\Validator\ResponseValidator</argument></arguments></virtualType>
In the command configuration we see that BraintreeAuthorizeRequest is specified as requestBuilder, that is a
Let's look closer on the requestBuilder arguments. This argument value is a list of builders, builder composite.
The BraintreeAuthorizeRequest builder contains the following builders (app/code/Magento/Braintree/etc/di.xml):
Copied to your clipboard<virtualType name="BraintreeAuthorizeRequest" type="Magento\Payment\Gateway\Request\BuilderComposite"><arguments><argument name="builders" xsi:type="array"><item name="customer" xsi:type="string">Magento\Braintree\Gateway\Request\CustomerDataBuilder</item><item name="payment" xsi:type="string">Magento\Braintree\Gateway\Request\PaymentDataBuilder</item><item name="channel" xsi:type="string">Magento\Braintree\Gateway\Request\ChannelDataBuilder</item><item name="address" xsi:type="string">Magento\Braintree\Gateway\Request\AddressDataBuilder</item><item name="vault" xsi:type="string">Magento\Braintree\Gateway\Request\VaultDataBuilder</item><item name="3dsecure" xsi:type="string">Magento\Braintree\Gateway\Request\ThreeDSecureDataBuilder</item><item name="device_data" xsi:type="string">Magento\Braintree\Gateway\Request\KountPaymentDataBuilder</item><item name="dynamic_descriptor" xsi:type="string">Magento\Braintree\Gateway\Request\DescriptorDataBuilder</item><item name="store" xsi:type="string">Magento\Braintree\Gateway\Request\StoreConfigBuilder</item><item name="merchant_account" xsi:type="string">Magento\Braintree\Gateway\Request\MerchantAccountDataBuilder</item></argument></arguments></virtualType>
The most important builder in this pool is Magento\Braintree\Gateway\Request\PaymentDataBuilder, the payment builder. It is responsible for the payment information part of the request.
Please see the Get payment information from frontend to backend for details about how payment information can be handled and Add a custom payment method to checkout: for information on how to add a custom payment integration to checkout page.
