Transaction

• X-API-Key · string required

  Your credential: either your `rr_live_` API key, or the Bearer token from `POST /api/v1/auth/client-credentials` (the same token every other API uses). The token may instead be sent as `Authorization: Bearer <token>`. A token follows the same IP whitelist as your keys, and all your tokens share one requests-per-minute allowance.

  Example: rr_live_xxxxxxxxxxxxx

• X-Timestamp · string required

  Current time in IST as `YYYY-MM-DD HH:MM:SS` (or `YYYY-MM-DDTHH:MM:SS`). Do not add a timezone suffix such as `+05:30`. Must be within 15 seconds of our server time.

  Example: 2026-10-03 10:30:45

• Content-Type · string required

  Request content type.

  Example: application/json

• 200 · application/json default

  Success

  Example

  {
      "status": "success",
      "message": "Transaction successful.",
      "data": {
          "reference_id": "TXN2026100300001",
          "tran_type": "CW",
          "status": "success",
          "amount": "2000.00",
          "rrn": "627610123456",
          "bank_name": "State Bank of India",
          "customer_aadhaar": "XXXXXXXX9012",
          "customer_balance": "9220.00",
          "commission": "4.0000",
          "settlement_status": "awaiting",
          "release_due_at": "2026-10-03T15:00:00+05:30",
          "mini_statement": null
      }
  }

• 200 · application/json

  Failed or rejected

  Example

  {
      "status": "success",
      "message": "Transaction limit exhausted.",
      "data": {
          "reference_id": "TXN2026100300002",
          "tran_type": "CW",
          "status": "failed",
          "amount": "2000.00",
          "rrn": null,
          "bank_name": "State Bank of India",
          "customer_aadhaar": "XXXXXXXX9012",
          "customer_balance": null,
          "commission": "0.0000",
          "settlement_status": "none",
          "release_due_at": null,
          "mini_statement": null
      }
  }

• 202 · application/json

  Pending: no final answer yet

  Example

  {
      "status": "success",
      "message": "The provider has not answered yet. Check the status endpoint; do not retry with a new reference_id.",
      "data": {
          "reference_id": "TXN2026100300003",
          "tran_type": "CW",
          "status": "pending",
          "amount": "2000.00",
          "rrn": null,
          "bank_name": "State Bank of India",
          "customer_aadhaar": "XXXXXXXX9012",
          "commission": "0.0000",
          "settlement_status": "none",
          "release_due_at": null
      }
  }

• INVALID_API_KEY · HTTP 401

  Invalid or revoked API key.

  {
      "message": "Invalid or revoked API key."
  }

• TIMESTAMP_OUT_OF_RANGE · HTTP 400

  Request timestamp is outside the ±15 second window.

  {
      "message": "Request timestamp is outside the ±15 second window."
  }

• service_not_enabled · HTTP 403

  AEPS is not enabled for your account. Contact your account manager to activate it.

  {
      "status": "error",
      "code": "service_not_enabled",
      "message": "AEPS is not enabled for your account. Contact your account manager to activate it."
  }

• RATE_LIMITED · HTTP 429

  Rate limit exceeded.

  {
      "message": "Rate limit exceeded."
  }

• agent_not_found · HTTP 404

  Agent not found.

  {
      "status": "error",
      "code": "agent_not_found",
      "message": "Agent not found."
  }

• agent_blocked · HTTP 403

  This agent is blocked. Contact support.

  {
      "status": "error",
      "code": "agent_blocked",
      "message": "This agent is blocked. Contact support."
  }

• duplicate_reference_id · HTTP 409

  This reference_id was already used. Send a new one.

  {
      "status": "error",
      "code": "duplicate_reference_id",
      "message": "This reference_id was already used. Send a new one."
  }

• kyc_required · HTTP 409

  Complete KYC for this agent before sending transactions.

  {
      "status": "error",
      "code": "kyc_required",
      "message": "Complete KYC for this agent before sending transactions."
  }

• daily_2fa_required · HTTP 409

  This agent has not done Daily 2FA today.

  {
      "status": "error",
      "code": "daily_2fa_required",
      "message": "This agent has not done Daily 2FA today."
  }

• amount_out_of_range · HTTP 422

  Amount must be between Rs 100 and Rs 10000.

  {
      "status": "error",
      "code": "amount_out_of_range",
      "message": "Amount must be between Rs 100 and Rs 10000."
  }

• bank_not_supported · HTTP 422

  This bank is not available for AEPS. Use the bank list endpoint.

  {
      "status": "error",
      "code": "bank_not_supported",
      "message": "This bank is not available for AEPS. Use the bank list endpoint."
  }

• SERVICE_UNAVAILABLE · HTTP 503

  Service temporarily unavailable. Please try again later.

  {
      "status": "error",
      "code": "SERVICE_UNAVAILABLE",
      "message": "Service temporarily unavailable. Please try again later."
  }

• noble_credentials_unavailable · HTTP 503

  Provider credentials are not available. Contact your partner.

  {
      "status": "error",
      "code": "noble_credentials_unavailable",
      "message": "Provider credentials are not available. Contact your partner."
  }

100/min