docs

List payment links

Lists payment links with advanced filtering, pagination, and search. Features: - Filter by active status - Search by product name, description, or unitLabel - Filter by amount (equal, between, greater, less) - Filter by date (last period, equal, between, after, before) - Pagination support

GET
/payment-links
  Lists payment links with advanced filtering, pagination, and search.
  
  Features:
  - Filter by active status
  - Search by product name, description, or unitLabel
  - Filter by amount (equal, between, greater, less)
  - Filter by date (last period, equal, between, after, before)
  - Pagination support

Authorization

api-key
AuthorizationBearer <token>

API key for merchant integrations. Send as Authorization: Bearer <your key>.

In: header

Query Parameters

page?number

Page number (1-based)

Default1
Range1 <= value
limit?number

Number of items per page

Default20
Range1 <= value <= 100
active?string

Filter by active status (true/false)

search?string

Search by product name, description, or unitLabel in line items (supports comma-separated terms)

amount?string

Amount filter condition (serialized string format: eq:100 or bt:10,100 or gt:50 or lt:200)

date?string

Date filter condition (serialized string format: last:7,days or between:2024-01-01,2024-12-31)

timezone?string

Timezone for date filtering

Default"UTC"

Response Body

application/json

curl -X GET "https://example.com/payment-links"
{
  "data": [
    {
      "id": "plink_abc123",
      "merchantId": "mer_xyz789",
      "active": true,
      "expiresAt": "string",
      "currency": "EGP",
      "computedAmount": 100000,
      "submitType": "PAY",
      "afterCompletion": {},
      "lineItems": [
        {}
      ],
      "createdAt": "string",
      "updatedAt": "string"
    }
  ],
  "totalCount": 42
}

Get customer by ID GET

Retrieves customer lifecycle information (id, type, name, email, phone, address, metadata). Response shape is identical to the `customer.*` webhook payload. For transaction counts + payment methods, call `GET /customers/:id/stats`.

Create a payment link POST

Creates a new payment link - a shareable link that merchants can send to customers. Features: - Supports multiple line items with adjustable quantities - Custom fields for collecting additional customer information - After completion settings (redirect or hosted confirmation) - Automatic amount calculation from line items - Validates currency consistency across line items