Payment method configuration
In the config.xml
file in your %Vendor_Module%/etc
directory, configure the options of your payment method. The following table contains the default options available for any payment method.
Option | Description | Value type |
---|---|---|
active |
is payment active by default | Boolean |
debug |
enables debug mode by default, for example log for request/response | Boolean |
debugReplaceKeys |
request/response fields that are masked in log | comma separtated list |
can_authorize |
whether payment method supports authorization | Boolean |
can_capture |
whether payment method supports the capture operation | Boolean |
can_void |
whether payment method supports the void operation | Boolean |
can_use_checkout |
whether payment method is available in storefront checkout | Boolean |
can_use_internal |
whether payment method is available in Admin order creation | Boolean |
currency |
supported currency | |
is_gateway |
is an integration with gateway | Boolean |
merchant_gateway_key |
encrypted merchant credential | string |
model |
payment method facade used for integration with Sales and Checkout modules | string |
order_status |
default order status | |
paymentInfoKeys |
transaction request/response fields displayed on payment information block (can be any fields from payment additional information) | list of comma separated values |
privateInfoKeys |
paymentInfoKeys fields which should not be displayed in customer payment information block (can be any fields from payment additional information) |
|
payment_action |
default action of payment for the payment method (authorize, sale) | authorize ,authorize_capture |
sort_order |
payment method order position on checkout/system configuration pages | integer |
title |
default title for a payment method | string |
Additionally to the default option, a payment method configuration can contain any other custom options.
Example
Following is the illustration of such configuration (config.xml
of the Braintree module)
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Store:etc/config.xsd">
<default>
<payment>
<braintree>
<model>BraintreeFacade</model>
<title>Credit Card (Braintree)</title>
<payment_action>authorize</payment_action>
<active>0</active>
<is_gateway>1</is_gateway>
<can_use_checkout>1</can_use_checkout>
<can_authorize>1</can_authorize>
<can_capture>1</can_capture>
<can_refund>1</can_refund>
<can_void>1</can_void>
<can_cancel>1</can_cancel>
<cctypes>AE,VI,MC,DI,JCB,CUP,DN,MI</cctypes>
<useccv>1</useccv>
<order_status>processing</order_status>
<privateInfoKeys>avsPostalCodeResponseCode,avsStreetAddressResponseCode,cvvResponseCode,processorAuthorizationCode,processorResponseCode,processorResponseText,liabilityShifted,liabilityShiftPossible,riskDataId,riskDataDecision</privateInfoKeys>
<paymentInfoKeys>cc_type,cc_number,avsPostalCodeResponseCode,avsStreetAddressResponseCode,cvvResponseCode,processorAuthorizationCode,processorResponseCode,processorResponseText,liabilityShifted,liabilityShiftPossible,riskDataId,riskDataDecision</paymentInfoKeys>
</braintree>
</payment>
</default>
</config>