Introduction

This guide walks through the complete Payment lifecycle—from creating a PaymentOrder, initiating Payments, and handling status callbacks, to closing, splitting, and settling the PaymentOrder. It aims to provide a clear understanding of how and where to integrate each step into your platform, supported by code examples, parameter references, and best practices.

Payment flow overview

Before diving into implementation details, the following diagram provides a high-level overview of the payment flow. It outlines the main steps in the PaymentOrder lifecycle and shows how the Tenant interacts with the Ping Payments API. This flow serves as a reference for understanding the order and purpose of each API call required to process and finalize a Payment.