Skip to main content

Introduction

Key Payout Features​

TrinexPay Payout services are designed to cover every step of the payout journey: initiation, validation, tracking, and confirmation.

1. Standard Payout API​

The core component that lets merchants initiate a payout programmatically using a secured POST request.

  • Payout Initiation: Simply call /StartPayout/initiate_payout with beneficiary and transaction details.
  • Custom Flow Control: You can control the user flow, integrate with your platform, and use your internal order IDs.
  • Secured Transactions: Use SHA-256 hash generation with your secret key for request validation.

2. Real-Time Payout Status Check​

Keep your platform up-to-date by checking payout status at any time using:

  • Endpoint: /Payoutstatus/check_status/{merchant_order}
  • Authentication: API Key must be passed in the header
  • Statuses Returned: Success, Pending, Initiated, Failed

3. Automated Callback Notifications​

Once a payout completes (or fails), TrinexPay sends a real-time POST callback to your server.

  • Webhook Triggered: On transaction success, failure, or status change.
  • Payload Includes: reference_id, utr, amount, status, and all relevant fields.
  • No Hash Required: Callback data is sent as plain JSON, making integration simple.

Hash-Based Security Mechanism​

All payout initiation requests are protected using SHA-256 hash verification, ensuring request integrity.

  • Fields in order: amount, bank_account, bank_ifsc, bank_name, merchant_order, name,
  • Use PHP or any language to hash this string
  • Always send hash in uppercase

Why Choose TrinexPay Payout System?​

  • 🔐 Secure by Design: Every request is protected by HMAC SHA-256 hashing
  • ⚡ Real-Time Execution: Get instant feedback on transaction statuses
  • 🧩 Flexible Integration: Designed for both direct API usage and system-to-system integrations
  • 🛡️ Transparent Error Reporting: Receive clear messages and traceable transaction references
  • 🛠️ Developer-First: Consistent structure, clear documentation, and real-time callback architecture