Transaction Processing

Back
Next

Transaction Processing

The platform enables real-time card transaction processing by acting as the secure integration layer between your systems and the card processor.

All authorizations, clearing, settlement, and funding operations are handled by the processor. The platform enforces card lifecycle rules, balance checks, and product configuration before returning decisions to the processor.

How Transaction Processing Works

When a cardholder uses a card or funds are loaded/unloaded:

  1. The request (purchase or funding) reaches the processor via the card network or API.

  2. The processor forwards the details to the platform in real time.

  3. The platform validates the card state, available balance, velocity limits, and product configuration rules.

  4. The platform returns an approve or decline decision to the processor.

  5. The processor completes the response to the network or API caller.

This flow applies to both payment usage and funding operations.

Supported Transaction Types

The platform supports the following transaction types:

Funding Transactions (Load / Unload operations)

  • Load – Adds funds to the card

  • Unload – Removes or partially removes funds from the card

  • Balance Adjustment – Adjusts the card balance up or down

  • Transfer Funds – Moves funds between cards

Payment Processing Transactions (Card usage)

  • Authorization – Real-time approval or decline for purchases, e-commerce, or ATM withdrawals (includes Authorization Reversal)

  • Presentment – Final settlement of an authorized transaction (funds are deducted)

  • Refund – Returns funds to the cardholder

  • Financial Reversal – Reverses a previously settled transaction

Additional types (cashback, incremental authorizations, chargebacks) can be enabled based on your Product settings.

Card State and Transaction Eligibility

Transaction outcomes are directly tied to the card’s current state (see Card Lifecycle Overview):

  • Only Active cards can be approved.

  • Suspended and Deactivated cards are automatically declined by the platform.

  • Product-level security and velocity controls are applied in addition to the state check.

Transaction Responses and Webhooks

Every transaction returns a clear response including:

  • Approval or decline status

  • Response code and decline reason (when applicable)

  • Unique transaction reference

  • Updated balance information (on approved transactions)

The platform also sends real-time webhook notifications for key events (authorizations, presentments, refunds, reversals, etc.). Subscribing to these webhooks is strongly recommended for keeping your systems in sync.

Retrieving Transaction History

You can retrieve the full transaction history for any card using the platform API. See the List Card Transactions endpoint for details on querying by card token and date range.