Overview - Almara Pay Documentation

This document describes how to handle card checkout flows, including callbacks, return, and cancellation endpoints.

URL Type	Method	Payload Type	Notes
`callbackUrl`	POST	JSON	Asynchronous notification of transaction status. Respond with HTTP 200.
`returnUrl`	POST	Form URL Encoded	Redirect user after payment. Include secure hash as query string.
`cancelUrl`	POST	Optional	Redirect user if transaction is canceled.

Security:
Secure your returnUrl with a special hash or signature passed as a query string to validate the integrity of the request.

Example:

https://checkout.merchant.com/return?hash=abcd1234

Usage:
Contains the same transaction data as the callbackUrl, allowing your system to confirm checkout details.

Checkout Flow: