> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.paylias.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Learn more about how money moves on Paylias

At its core, Paylias enables seamless movement of funds between users and platforms through a robust and standardized payment layer. Whether you're sending money to a friend or collecting payment at checkout, every transaction in Paylias flows through one of two fundamental types: Push Payments and Pull Payments.

## Push Payments

Push payments empower users to initiate transfers from their own account to another customer’s alias. This type of payment is typically used in peer-to-peer (P2P) or person-to-business (P2B) scenarios.

In a push payment, the sending customer initiates the transaction by entering the recipient’s alias and amount. Their financial platform constructs a payment request and submits it to Paylias. Paylias validates the request and issues a Payment Submission Task, which must be completed by the initiating platform before the payment can proceed. Once submitted, Paylias delivers a Payment Admission to the recipient’s financial platform, confirming receipt. Finally, a Transaction is created and both platforms are notified so they can update their customers accordingly.

```mermaid Push payment theme={null}
sequenceDiagram
    participant CA as Customer A
    participant PA as Partner A
    participant Paylias
    participant PB as Partner B
    participant CB as Customer B

    CA->>PA: Initiates payment to alias
    PA->>Paylias: Submits Payment
    Paylias->>PA: Returns Submission Task
    PA->>CA: Processes Submission Task
    PA->>Paylias: Submits Task Response
    Paylias->>PB: Submits Payment Admission
    Paylias->>PA: Submits Transaction Confirmation
    Paylias->>PB: Submits Transaction Confirmation
    PA->>CA: Show success
    PB->>CB: Show success

```

## Pull Payments

Pull payments facilitate merchant-led transactions—ideal for e-commerce checkouts, or service payments. In a pull payment, a merchant collects the customer’s alias and order information, then initiates the payment from their financial platform.

The partner submits this request to Paylias, which verifies the request and sends a Payment Admission to the customer’s financial platform. Paylias also issues a Payment Admission Task, which the receiving partner must process by collecting customer authorization. Once completed, a Transaction is created and both sides are notified of the result.

```mermaid Pull payment theme={null}
sequenceDiagram
    participant M as Merchant
    participant PM as Merchant Partner
    participant Paylias
    participant PC as Customer Partner
    participant C as Customer

    M->>PM: Initiates payment (alias + order)
    PM->>Paylias: Submits Payment
    Paylias->>PC: Submits Payment Admission
    Paylias->>PC: Submits Admission Task
    PC->>C: Collects Customer Authorization
    PC->>Paylias: Submits Task Response
    Paylias->>PM: Transaction Confirmation
    Paylias->>PC: Transaction Confirmation
    PM->>M: Show success
    PC->>C: Show success

```