External Payment Requests

You can configure MATRIXX Engine to automatically request external payments based on a recurring cycle.

When Automatic Recurring Recharge is enabled at the system level, and balances used to pay for recurring charges are funded by External Payment Requests, ExternalPaymentRequest events are generated before the start time of each purchase package cycle. For each purchase package cycle, one ExternalPaymentRequest event is generated for each impacted balance that has External Payment Request enabled at the system level. If multiple purchased items in the purchase package apply recurring charges to the same balance, only one ExternalPaymentRequest event is generated. The ExternalPaymentRequest event identifies the purchase package and the recurring interval for which the payment is for. For information about enabling Automatic Recurring Recharge and External Payment Requests, see the discussion about global system configuration in MATRIXX Configuration. For more information about ExternalPaymentRequest events, see the discussions about MtxExternalPaymentRequestEvent and MtxExternalPaymentRequestInfo in MATRIXX Integration.

During recurring processing, all the External Payment received for a purchase package cycle is applied. If a purchased item in a purchase package is purchased or resumed after the ExternalPaymentRequest events have been generated for the upcoming cycle, recurring processing for the next purchase package cycle might not succeed due to insufficient funds. If a purchased item in a purchase package is canceled or suspended after the ExternalPaymentRequest events are generated for the upcoming cycle, the extra payment collected for the next purchase package cycle is not refunded and remains in the wallet. For more information about ExternalPaymentRequest events, see the discussion about external payment MDCs in MATRIXX Subscriber Management API.