Sample Payment Gateway Properties File

The following example payment gateway properties show the format and sample parameters for connecting to the gateway. For more information about integrating with a third-party payment gateway, contact MATRIXX Support.

This example file, /opt/mtx/conf/payment-service.yaml, includes the following parameters for the Braintree Payment Gateway Adapter:
  • environment
  • merchantId
  • publicKey
  • privateKey
  • failOnDuplicatePaymentMethod
  • verifyCard
  • recurringOverride
Note: A payment service can have more than one configuration, but it must have one configuration named default. A payment gateway instance is not available without a default configuration. For a single payment gateway configuration, only the default configuration is required. For information about defining additional configurations for a payment service, see the discussion about payment service multiple configurations.
payment:
  gateway:
    braintree:
      configs:
        default:
          environment: sandbox
          merchantId: nwqrtyrnkwfwc9m5
          publicKey: 64qnktpmvhk447kb
          privateKey: 93e7d2262d8f1506ec9afe448374ced5p

          # If true, set flag failOnDuplicatePaymentMethod when creating payment method
          failOnDuplicatePaymentMethod: false

          # if true, will verify card when we set it to default
          verifyCard: false

          # UDF mapping field name
          # set UDF fraud_transaction_type to the value of MDC's field TransactionType
          #udfFieldMap.fraud_transaction_type: TransactionType
          userDefinedFields:
            fraud_transaction_type:
              mdcFieldName: TransactionType
              defaultValue: CARE
              systemInitiatedValue: AutoPay

          # RecurringOverride is a MDC field name.
          # The field would be part of the caller supplied ChargeMethodExtension recurringOverride:
          merchantAccountLookupType: PaymentMethodType
          merchantAccountLookup:
            AmexExpressCheckoutCard:
              id: merchantId01
            AndroidPayCard:
              id: merchantId02
            ApplePayCard:
              id: merchantId03
            CoinbaseAccount:
              id: merchantId04
            CreditCard:
              id: merchantId05
            "[CreditCard.AmericanExpress]":
              id: merchantId05
            EuropeBankAccount:
              id: merchantId06
            MasterpassCard:
              id: merchantId07
            PayPalAccount:
              id: merchantId08
            UnknownPaymentMethod:
              id: merchantId05
            UsBankAccount:
              id: merchantId10
            VenmoAccount:
              id: merchantId11
            VisaCheckoutCard:
              id: merchantId12