Providing Address and Device Information

If the Payment Gateway Provider requires additional information, for example, for risk management services, it is possible to include information such as a billing, shipping address, and device data in the request.

For the Braintree Payment Gateway Provider, the MtxBraintreeChargeMethodExtension MATRIXX Data Container (MDC) extends the MtxChargeMethodExtension MDC. It contains a shipping address, billing address, device data, a unique order ID used in the authorize or settlement request, and a payment reason. To include information in addition to these fields, add a custom MDC extending the MtxBraintreeChargeMethodExtension MDC to hold the information. For more information about creating custom MDCs, see the discussion about adding a custom MDC in MATRIXX Installation and Upgrade.

To include address information, set values in MtxAddressData. For more information about MtxAddressData, see the discussion about MtxAddressData in MATRIXX Subscriber Management API.

Note: The Braintree Payment Gateway Adapter can validate the billing postal code (ZIP code). For more information, see the discussion about payment method validation.

Any risk data returned by the Payment Gateway Provider is included in the MtxPaymentAuthorizationEvent Event Detail Record (EDR) and in SubMan API responses.