API Documentation

Appearance

Easy Paisa ​

Use this page to create payments via mobile carrier billing using the common Payment API endpoint. Authentication and base URL follow the Payment API docs.

  • Base URL: https://api.paylander.com/api/v1/payment/
  • Endpoint: POST /v1/payment/

Supported Currencies ​

  • PKR

Redirect Flow ​

Use when subscriber interaction happens in our hosted frontend. Your backend only specifies the payment method type.

Common fields (see Payment API):

  • channel (UUID, required)
  • amount (object, required)
    • currency (ISO 4217, required)
    • value (string, required)
  • external_id (string, optional)
  • return_url (string, recommended)
  • payment_method (object, required)

payment_method (type: easy_paisa) ​

Required:

  • type → "easy_paisa"

Example Request ​

json
{
  "channel": "8fec39b6-c41b-46d6-b219-61d115fdfa2d",
  "amount": { 
    "currency": "PKR", 
    "value": "1101.00" 
  },
  "payment_method": { 
    "type": "easy_paisa"
  },
  "return_url": "https://your-company.com/success",
  "callback_url": "https://your-company.com/callback",
  "external_id": "YOUR_ORDER_NUMBER"
}

Example Response ​

json
{
  "status": "processing",
  "transaction_id": "b7c3f1e4-5a2d-4f8c-9d1b-2a3f7e9c6d10",
  "amount": { 
    "currency": "PKR", 
    "value": "1101.00" 
  },
  "redirect_url": "https://pay.paylander.com/easy_paisa/b7c3f1e4-5a2d-4f8c-9d1b-2a3f7e9c6d10/",
  "channel": "8fec39b6-c41b-46d6-b219-61d115fdfa2d",
  "payment_method": {
    "type": "easy_paisa",
    "account": "123456789"
  },
  "create_date": "2025-10-15T12:05:00.000000+00:00"
}

Server-to-Server ​

You collect the customer data; send details in payment_method.

Common fields (see Payment API):

  • channel (UUID, required)
  • amount (object, required)
    • currency (ISO 4217, required)
    • value (string, required)
  • external_id (string, optional)
  • return_url (string, recommended)
  • payment_method (object, required)

payment_method (type: easy_paisa) ​

Required:

  • type → "easy_paisa"
  • account → (string, requred) User's easy paisa account number
json
{
  "channel": "8fec39b6-c41b-46d6-b219-61d115fdfa2d",
  "amount": { 
    "currency": "PKR", 
    "value": "1101.00" 
  },
  "payment_method": { 
    "type": "easy_paisa", 
    "account": "123456789" 
  },
  "return_url": "https://your-company.com/success",
  "callback_url": "https://your-company.com/callback",
  "external_id": "YOUR_ORDER_NUMBER"
}

Example Response ​

json
{
  "status": "processing",
  "transaction_id": "b7c3f1e4-5a2d-4f8c-9d1b-2a3f7e9c6d10",
  "amount": { 
    "currency": "PKR", 
    "value": "1101.00" 
  },
  "redirect_url": "https://pay.paylander.com/easy_paisa/b7c3f1e4-5a2d-4f8c-9d1b-2a3f7e9c6d10/",
  "channel": "8fec39b6-c41b-46d6-b219-61d115fdfa2d",
  "payment_method": {
    "type": "easy_paisa",
    "account": "123456789"
  },
  "create_date": "2025-10-15T12:05:00.000000+00:00"
}

© 2025 Paylander