Endpoint

POST https://primexpay.in/api/merchant/initiate-fund-transfer

Request Parameters

• authEmail (string, required)
• apiKey (string, required)
• amount (number, required)
• custRefNo (string, optional)
• beneficiary (object, required):
  • name
  • accountNumber
  • ifscCode
  • bankName (optional)

Sample Request

{
  "authEmail": "merchant@example.com",
  "apiKey": "test_api_key_123",
  "amount": 150,
  "custRefNo": "REF20250626001",
  "beneficiary": {
    "name": "John Doe",
    "accountNumber": "1234567890",
    "ifscCode": "HDFC0001234",
    "bankName": "HDFC Bank"
  }
}

CURL Request

curl -X POST https://primexpay.in/api/merchant/initiate-fund-transfer \
  -H "Content-Type: application/json" \
  -d '{
    "authEmail": "merchant@example.com",
    "apiKey": "test_api_key_123",
    "amount": 150,
    "custRefNo": "REF20250626001",
    "beneficiary": {
      "name": "John Doe",
      "accountNumber": "1234567890",
      "ifscCode": "HDFC0001234",
      "bankName": "HDFC Bank"
    }
  }'

Sample Success Response

{
  "success": true,
  "message": "Fund transfer initiated successfully",
  "txnId": "SMPPO1750899999999",
  "status": "Pending",
  "amount": "150.00",
  "custRefNo": "REF20250626001",
  "beneficiary": {
    "name": "John Doe",
    "accountNumber": "1234567890",
    "ifscCode": "HDFC0001234",
    "bankName": "HDFC Bank"
  }
}

Callback (Webhook) Format

{
  "custRefNo": "REF20250626001",
  "status": "Completed",
  "amount": "150.00",
  "message": "Payout processed successfully",
  "date": "26/06/2025, 04:20:17",
  "txnId": "SMPPO1750899999999",
  "utrNumber": "999887766543"
}

Sample Error Responses

{
  "success": false,
  "message": "Invalid IFSC Code format. Expected format: XXXX0XXXXXX"
}

Notes

• Platform fee calculated per merchant
• Webhook updates final status
• This API only works for merchants with payout enabled.
• The payout amount must be within min/max limits.
• IP whitelisting is required for added security.
• Status can be: pending, completed, or failed.