Skip to main content

Requirements

This document outlines the critical requirements, transaction flow, and receipt processing guidelines for App2App integration.

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

Transaction Flow​

  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

Receipt Processing​

Receipt data is returned as formatted lines that can be directly printed or displayed by the integrating application (integrator's app resides on the terminal as well thus it can use the printer):

  • Text content with formatting instructions
  • Size indicators for different font sizes
  • Alignment specifications (Left/Center/Right)
  • Style indicators (Normal/Bold)