Skip to main content

Message Flow

Payen Platform APM Message Flow

The following diagram shows the message flow and interactions involved in a Payen Platform transaction and the responsibilities of each party involved.

StepDescription
1APM Initialisation: Merchant posts https://pripframev2.trustpayglobal.com/ipframe/apm/initialise. The Payen platform validates the request, creates a new transaction, and returns a requestKey to be used in subsequent calls.
2APM Processing: Merchant redirects the customer’s browser to /ipframe/apm/process with the requestKey and chosen apmMethod. The platform validates the request, initiates the payment with the APM provider, and manages the customer interaction.
3Customer Payment: The customer completes the payment on the third-party APM provider. Managed by the platform, with no action required from the merchant.
4Browser Return: After payment, the platform redirects the customer back to the merchant return URL. The merchant should not rely on this return for final payment status.
5Final Transaction Status: The merchant receives the final payment result from the Payen platform by querying the status API using the responseKey, or via a server-to-server notification sent by the Payen platform to the configured notification URL.

This message flow ensures PCI compliance is maintained, and the Payen platform handles sensitive payment data without exposing it to the merchant or browser.