IMPS Payouts

Use this page to create payouts using IMPS (Immediate Payment Service), a real-time interbank transfer method in India.

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

Overview

IMPS allows merchants to send payouts instantly to recipients’ Indian bank accounts using their account number and IFSC (bank code).
Transactions are usually processed within seconds and available 24/7.

Common fields (see Payout API):

• channel (UUID, required)
• amount (object, required)
  • currency (ISO 4217, must be INR)
  • value (string, required)
• external_id (string, required) → your internal order or payout ID
• description (string, optional)
• payout_method (object, required)

---

payout_method (type: imps)

Required:

• type → "imps"
• bank_code → IFSC code of recipient’s bank
• first_name → Recipient’s first name
• last_name → Recipient’s last name
• phone → Recipient’s phone number (E.164 format)
• email → Recipient’s email address
• account_number → Recipient’s bank account number

---

Example Request

{
  "channel": "b96d5b92-8f34-4b12-9b16-5f047b57c901",
  "amount": {
    "currency": "INR",
    "value": "2500.00"
  },
  "payout_method": {
    "type": "imps",
    "bank_code": "HDFC0000456",
    "first_name": "Ravi",
    "last_name": "Kumar",
    "phone": "919812345678",
    "email": "ravi.kumar@example.in",
    "account_number": "123456789012"
  },
  "description": "Withdrawal #49283",
  "external_id": "ORDER-49283",
  "callback_url": "https://your-company.com/callback"
}

Example Response

{
  "status": "processing",
  "transaction_id": "b5cff6ed-f3f0-46df-a390-2ffdb11430f4",
  "external_id": null
}

Notes

• IMPS payouts are only available for Indian Rupee (INR).
• The status field can be:
  • processing — payout created and awaiting confirmation.
  • completed — funds successfully transferred.
  • failed — payout could not be completed (check logs).
• To query payout status, use GET /api/v1/payout/?channel=<uuid>&transaction_id=<uuid>.

---

Error Handling

See Error Responses for the full list of possible API errors.