Flow Description

Transaction Initiation

Cardholder Action: The cardholder initiates a transaction at the merchant’s POS or online checkout by entering their card details or using contactless methods.

Merchant System: The merchant system captures transaction details (amount, card data, merchant identifier) and generates a transaction request.

Request Routing

Merchant to Card Network: The merchant system sends the transaction request directly to the Card Network.

Card Network to Wirex Pay: The Card Network identifies the appropriate processing route (via the card’s BIN) and routes the request to Wirex Pay.

Wirex Pay Processing

Verification & Fraud Checks: Wirex Pay validates the cardholder’s details and performs initial fraud detection.

Risk & Limits Checks: Additional risk management processes are executed, including verifying transaction amounts against preset limits.

Master Account Balance Check: For corporate or group accounts, Wirex Pay checks the master account to confirm sufficient funds.

External Partner Confirmation

Confirmation Request: Wirex Pay sends a confirmation request via webhook to the external risk management partner, including transaction details and risk metrics.

Partner Response: The external partner evaluates the data and returns a confirmation response (approve/deny) via webhook response .

❗️

Please not - expected timing for Confirmation Request Webhook response is <= 500ms.

Master Account Debit Operation

Debit Operation: Based on the combined risk assessment and external confirmation, Wirex Pay performs a master account debit operation to reserve or withdraw the funds for the transaction. This step ensures that the transaction amount is debited from the master account before final authorization.

Notification: Wirex Pay sends a notification webhook to the partner, informing them that the partner’s confirmation response has been received and logged.

Final Authorization & Routing

Final Decision: Wirex Pay compiles the final authorization response, incorporating all checks and the debit operation outcome.

Routing: Wirex Pay sends the final authorization decision to the Card Network, which then routes it to the Merchant System.

Finalization at the Merchant

Merchant Notification: The Merchant System receives the final authorization response and notifies the cardholder of the outcome (approved or declined).

Settlement: If approved, the transaction is captured and later settled during the batch processing stage.

Communication

Effective and reliable communication between Wirex Pay and its external partner is crucial to ensure that every transaction is thoroughly evaluated. In this revised flow, Wirex Pay initiates the conversation by sending confirmation-related notifications via webhooks

Webhook-Based Notifications

Wirex Pay proactively communicates with its external partner by sending webhooks for the following events:

Confirmation Request Webhook:

https://partner.wirexpaychain.com/docs/webhooks#cardtransactionnewwebhook

When a transaction reaches the point where external validation is needed, Wirex Pay sends a webhook to the partner. This webhook includes all relevant transaction details (such as transaction ID, amount, user) along with an instruction for the partner to evaluate the transaction.

Confirmation/Failed Notification Webhook:

https://partner.wirexpaychain.com/docs/webhooks#cardtransactionupdatewebhook

If, during the external evaluation process, an issue occurs (for example, a timeout or data validation error) or if the transaction is deemed high-risk based on preliminary analysis, Wirex Pay sends a separate webhook notifying the partner of a “failed” or “confirmation” status. This ensures that the partner is kept in the loop regarding the transaction’s evolving status.