POS API / Payment

Payment Page

Redirect customers to a Quickei-hosted payment page for POS orders.

How the Payment Page Works

Create an order with payment_method set to 'payment_page' or 'both'.

The API returns a payment_url — redirect your customer or embed it in an iframe.

The customer pays using their preferred Quickei wallet method.

Your callback_url receives a webhook and the page shows a success confirmation.

Payment Page URL

URL {{domain}}/pay/pos/{order_id}

Payment Methods

Value	Behavior
`qr_only`	Only QR code data is returned — no hosted page. Use for app-to-app payment.
`payment_page`	Only the hosted payment page URL is returned — no QR code data.
`both`	Both QR code data and payment page URL are returned (default).

Status Polling

GET {{domain}}/pay/pos/{order_id}/status

The payment page automatically polls this endpoint to update the UI in real time.

Integration Example

// 1. Create order
$response = Http::withBasicAuth(
    $clientId, $clientSecret
)->post('{domain}/merchant-api/pos/v1/orders', [
    'amount'         => 25.00,
    'currency'       => 'EUR',
    'payment_method' => 'payment_page',
    'reference'      => 'ORDER-123',
    'callback_url'   => 'https://your-site.com/webhook',
]);

$paymentUrl = $response['data']['payment_url'];

// 2. Redirect customer
return redirect($paymentUrl);

Payment Page Features

Real-time Updates

The page automatically detects payment and shows confirmation.

Mobile Responsive

Optimized for all screen sizes with QR code display.

Countdown Timer

Shows the remaining time before the order expires.

Webhooks Response Codes