Skip to main content

Transaction Flow

This document explains how transactions flow between your app and the Paynt Payment App.

Overview​

  1. Your app creates a request object and converts it to JSON
  2. Launches Paynt app with the appropriate intent action and JSON payload
  3. Paynt app processes the transaction/admin operation
  4. Paynt app returns result with RESULT_OK/RESULT_CANCELED and response JSON
  5. Your app processes the response and updates the UI accordingly

Critical Requirements​

  • Amount Format: Always pass amounts in cents/minor currency units (e.g., 1250 = €12.50)
  • Reversal UTI: For reversals, use the original transaction's UTI
  • Activity Launch Mode: The Paynt app uses singleTask launch mode
  • JSON Serialization: All request/response data is JSON serialized, using Gson is highly recommended
  • Completion Amount: Amount must be lower or equal to pre-authorization amount