LOTUSDIAM Partner API

Use this API to create payouts and check payout status.

Base URL

https://lotusdiam.com/api/partner/v1

Your administrator provides an API Key and API Secret. Keep both private.

Authentication

Send these headers with every request:

X-API-Key: YOUR_API_KEY
X-API-Secret: YOUR_API_SECRET
Content-Type: application/json

POST Create payout

/payouts

{
  "clientOrderId": "YOUR-UNIQUE-ORDER-1001",
  "beneficiaryName": "Rahul Kumar",
  "beneficiaryMobile": "9876543210",
  "accountNumber": "123456789012",
  "ifscCode": "HDFC0001234",
  "bankName": "HDFC Bank",
  "amount": 100,
  "mode": "IMPS",
  "remark": "Invoice payment"
}

clientOrderId must be unique for your client account. Sending the same value again returns the existing order instead of creating a new payout.

GET Check status

/payouts/{lotusOrderId}

Example:

GET https://lotusdiam.com/api/partner/v1/payouts/LLABC123

Success response

{
  "success": true,
  "orderId": "LLABC123",
  "status": "PENDING",
  "utr": null
}

Status values

Status	Meaning
PROCESSING / PENDING	Transfer is being processed.
SUCCESS	Transfer completed. UTR may be available.
FAILED / REFUNDED	Transfer failed; retailer balance is refunded where applicable.

Important

Never share the API Secret in screenshots or public chats.
Each API key uses the retailer balance selected by the administrator.
Contact the administrator to disable or replace a compromised key.