Home
MATRIXX Pay Now
Pay Now Overview
MATRIXX Pay Now enables the Charging Server to request immediate payment for product offer and bundle purchases, postpaid balance payments, and recharges from a Payment Gateway Provider. Subscribers can make quick and secure purchases using payment methods such as credit and debit cards.
Pay Now Payment Process
Before beginning the Pay Now authorization process, the client must request a client authorization token from the Payment Service and the Payment Service must request a payment method token from the Payment Gateway Provider.
Payment Settlement Process
After a payment authorization completes successfully and before the authorization expires, a payment settlement is attempted.
Payment Settlement Events
When a Pay Now payment settlement completes, the Charging Server generates an MtxPaymentSettlementEvent Event Detail Record (EDR) that is separate from the authorization EDR.

Welcome
MATRIXX Release Notes
MATRIXX Architecture
MATRIXX Installation and Upgrade
MATRIXX Configuration
MATRIXX Security
MATRIXX Integration
MATRIXX Diameter Integration
MATRIXX Call Control Framework Integration
MATRIXX TM Forum Integration
MATRIXX 5G Integration
MATRIXX 5G Event Streaming
MATRIXX Event Streaming
MATRIXX Administration
MATRIXX Web App Administration
MATRIXX Monitoring and Logging
MATRIXX Policy
MATRIXX Kafka CDR Consumer
MATRIXX Pricing and Rating
MATRIXX Pay Now
- About MATRIXX Pay Now
  MATRIXX Pay Now describes the tasks required to configure MATRIXX Pay Now and the MATRIXX Payment Service that enables Pay Now and provides overviews, recommendations, and conceptual discussions to help you understand these tasks.
- Pay Now Overview
  MATRIXX Pay Now enables the Charging Server to request immediate payment for product offer and bundle purchases, postpaid balance payments, and recharges from a Payment Gateway Provider. Subscribers can make quick and secure purchases using payment methods such as credit and debit cards.
  - Pay Now Components
    Pay Now involves multiple components that work together to recognize immediate payment for one-time _glossary/product_offer.html and _glossary/bundle.html purchases.
  - Payment Service
    The Payment Service delivers messages between MATRIXX Charging Application and a Payment Gateway Provider. Messages include authorization requests and responses. Authorization requests include the current subscriber or group payment token.
  - Pay Now Payment Process
    Before beginning the Pay Now authorization process, the client must request a client authorization token from the Payment Service and the Payment Service must request a payment method token from the Payment Gateway Provider.
    - Pay Now Authorization Process
      The Pay Now authorization occurs when a Payment Gateway Provider approves a payment authorization request sent by the MATRIXX Charging Application.
    - Payment Settlement Process
      After a payment authorization completes successfully and before the authorization expires, a payment settlement is attempted.
      - Deferred Payment Settlements
        When you purchase a _glossary/catalog_item.html with Pay Now, you can specify that MATRIXX Charging Application does not request the payment settlement immediately. This may be necessary, for example, due to regulatory requirements for payment settlements.
      - Payment Settlement Events
        When a Pay Now payment settlement completes, the Charging Server generates an MtxPaymentSettlementEvent Event Detail Record (EDR) that is separate from the authorization EDR.
  - Pay Now Payment Methods
    Payment tokens represent payment methods, such as a credit card number, but do not contain actual payment information. They are generated by the Payment Service and must be added to subscriber or group wallets using the SubMan APIs.
  - Pay Now Catalog Item Purchases
    When purchasing catalog items, there are multiple options for specifying how payments are made.
  - Pay Now Payments and Recharges
    Use Pay Now to make one-time top-ups to prepaid actual currency balances (recharges) or one-time payments to postpaid main balances.
  - Pay Now Automatic Recharge
    Automatic recharge makes immediate payments to subscriber and group wallets according to a predefined schedule, automatically based on recurring billing and purchased item cycles, or when a balance threshold is triggered due to a balance increase.
  - Pay Now Refunds
    Using the SubMan APIs, you can request a subscriber or group Pay Now payment refund to prepaid or postpaid main balances. The Payment Service also supports partial refunds for the Braintree Payment Gateway Provider.
  - Pay Now Normalization
    Normalizers can be applied on the temporary MtxEventChargeNormalizationInfo MDC to use different General Ledger (GL) account names and GL transaction types based on the payment type, update type, event type, and tax class.
  - Pay Now Operations
    A Pay Now operation can be initiated by multiple actions, such as a purchase authorization, settlement, and refund.
- Configuring Pay Now
  System administrators must configure the Payment Service to enable communication between Apache ActiveMQ, MATRIXX Engine, and the Payment Service. In addition, they must configure the Payment Service third-party Payment Gateway Provider properties file location.
- Manage the Payment Service
  This procedure describes how to run the Payment Service as a service.
- Pay Now Payment Gateway Adapters
  Each Payment Gateway Adapter can support multiple features, operations, and payment methods.
- Pay Now APIs
  Each client that communicates with the Payment Service has different requirements based on the payment gateways that it supports. Client developers should contact MATRIXX Support for information specific to their client implementation.
MATRIXX Subscriber Management
MATRIXX Subscriber Management API
MATRIXX Business API SDK
My MATRIXX Help
MATRIXX Backoffice Customer Tool Help
MATRIXX Third-Party Licenses
Glossary

Payment Settlement Events

When a Pay Now payment settlement completes, the Charging Server generates an MtxPaymentSettlementEvent Event Detail Record (EDR) that is separate from the authorization EDR.

MtxPaymentSettlementEvent Fields describes the MtxPaymentSettlementEvent EDR fields.

Table 1. MtxPaymentSettlementEvent Fields
Field	Type	Description
Amount	Decimal	Payment amount.
PaymentToken	BLOB	Payment token used to authorize the payment.
PaymentMethodName	String	Optional descriptive name for the payment method.
PaymentMethodResourceId	UINT32	Resource ID of payment method. The resource ID is auto-generated when the payment method is created using the SubMan APIs.
PaymentSettlementTransactionId	BLOB	The payment settlement transaction ID. The value comes from the payment gateway and Payment Service.
PaymentAuthorizationEventId	String	The ID of the corresponding payment authorization event.
Status	UINT16	Indicates the status of the payment settlement: 0 — Succeeded 1 — Rejected by the payment gateway 2 — Timeout
PaymentGatewayResult	String	Result returned from the payment gateway.
PaymentMethodType	String	Descriptive name of the payment method type used to authorize payment.
DeferredSettlement	Bool	Indicates if the settlement was deferred at the time it was charged. The GL processor uses this field to determine if it must read the events for the original charges to find charge records with revenue recognition type pending_settlement (6).