Payment Statuses

Learn about all order, payment, and payment link statuses and their transitions.

This guide explains all possible statuses for orders, payment links, and payments in Paysera Checkout.

Three Distinct Status Types

Paysera Checkout has three separate status types that track different entities:

• Order Status - Tracks the overall order state
• Payment Status - Tracks individual payment attempts
• Payment Link Status - Tracks payment link availability

Order Statuses

Orders track the overall transaction state. An order can have multiple payment attempts.

Status Diagram

Status Reference

Status	Code	Description	Terminal
Pending Payment	pending_payment	Order created, awaiting payment	No
Paid	paid	Order total amount equals amount paid	No
Canceled	canceled	Order was canceled before anything was paid	Yes
Closed	closed	Reserved, not currently used	Yes

Status Details

pending_payment

Initial state after order creation.

Transitions to:

• paid - When total amount is paid
• canceled - When canceled while nothing is paid

Actions available:

• Create payment link
• Cancel order (in the Paysera Merchant Portal)

paid

Order has been fully paid (amount paid equals order amount). A paid order cannot be canceled.

Actions available:

• Process refund (if supported)

canceled

Order was canceled before anything was paid — by the merchant in the Paysera Merchant Portal, or by Paysera support. Its active payment links are canceled as well, and an order canceled webhook is sent.

Terminal state - no further actions.

closed

Reserved for future use. No order is set to closed today.

Payment Link Statuses

Payment links control access to the payment flow.

Status	Code	Description	Terminal
Active	active	Link is valid and can be used	No
Completed	completed	Payment completed via this link	Yes
Expired	expired	Link has expired	Quasi*
Canceled	canceled	Link was canceled	Yes

*expired can transition to completed if a payment settles during bank flow.

No Failed Status

Payment links do not have a failed status. If a payment attempt fails, the link remains active (unless expired or canceled), allowing retry.

Payment Statuses

Payments track individual payment attempts through the bank/gateway flow.

Status	Code	Description	Terminal
Initiated	initiated	Payment request created	No
Awaiting Auth	awaiting_authorization	Requires SCA (3DS)	No
Authorized	authorized	Bank authorized	No
Processing	processing	Internal processing	No
Pending Settlement	pending_settlement	Clearing stage	No
On Hold	on_hold	Compliance review	No
Settled	settled	Funds transferred	No*
Failed	failed	Technical failure	Yes
Rejected	rejected	Bank refused	Yes
Canceled	canceled	Canceled	Yes
Expired	expired	Timeout	Yes
Refunded	refunded	Returned to payer	Yes
Chargeback	chargeback	Dispute initiated	Yes

*settled can transition to refunded or chargeback.

Webhook Events

When a payment is registered against an order, you receive an order-snapshot webhook (event.type = "order") carrying the full order state, and a thin payment webhook (event.type = "payment") for the payment itself. Branch on order.status / payment.status rather than on the event name. See the Webhook Events Reference for the exact events and payloads.

Handling Statuses in Code

PHP Example

<?php

class PaymentStatusHandler
{
    public function handleWebhook(array $data): void
    {
        $orderStatus = $data['order']['status'];
        $reference = $data['order']['merchant_order_id'];

        switch ($orderStatus) {
            case 'paid':
                $this->handlePaid($reference, $data);
                break;

            case 'pending_payment':
                $this->handlePendingPayment($reference, $data);
                break;

            case 'canceled':
                $this->handleCanceled($reference, $data);
                break;

            case 'closed':
                $this->handleClosed($reference, $data);
                break;

            default:
                $this->logUnhandledStatus($orderStatus, $reference);
        }
    }

    private function handlePaid(string $reference, array $data): void
    {
        // Update order in database
        $this->orderRepository->updateStatus($reference, 'paid');

        // Send confirmation email
        $this->mailer->sendOrderConfirmation($reference);

        // Trigger fulfillment
        $this->fulfillmentService->process($reference);
    }

    private function handlePendingPayment(string $reference, array $data): void
    {
        // Order is awaiting payment
        $this->orderRepository->updateStatus($reference, 'awaiting_payment');
    }

    private function handleCanceled(string $reference, array $data): void
    {
        // Order was canceled
        $this->orderRepository->updateStatus($reference, 'canceled');
    }

    private function handleClosed(string $reference, array $data): void
    {
        // Order was closed
        $this->orderRepository->updateStatus($reference, 'closed');
    }
}

JavaScript Example

class PaymentStatusHandler {
  async handleWebhook(data) {
    const orderStatus = data.order.status;
    const reference = data.order.merchant_order_id;

    const handlers = {
      paid: () => this.handlePaid(reference, data),
      pending_payment: () => this.handlePendingPayment(reference, data),
      canceled: () => this.handleCanceled(reference, data),
      closed: () => this.handleClosed(reference, data),
    };

    const handler = handlers[orderStatus];
    if (handler) {
      await handler();
    } else {
      console.warn(`Unhandled status: ${orderStatus}`);
    }
  }

  async handlePaid(reference, data) {
    await this.orderRepository.updateStatus(reference, 'paid');
    await this.mailer.sendOrderConfirmation(reference);
    await this.fulfillmentService.process(reference);
  }

  // ... other handlers
}

Status Querying

You can query order status via API:

curl -X GET https://api.paysera.com/merchant-order/integration/v1/orders/ORDER_ID \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Response:

{
  "id": "a6f2b8e3-5e5f-47d9-b13f-87ed2db2938a",
  "status": "paid",
  "amount": 2500,
  "currency": "EUR",
  "amountPaid": 2500,
  "balanceDue": 0,
  "createdAt": 1736433270,
  "updatedAt": 1736433570
}

Related Documentation

• Payment Statuses Reference - Complete status tables
• Webhooks - Handle status change notifications
• Payment Flow - Understand the complete payment lifecycle