> ## Documentation Index
> Fetch the complete documentation index at: https://docs.grailpay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Transaction Intelligence: Accounts Receivable

Transaction Intelligence is part of GrailPay’s risk evaluation system that helps you assess the safety of a specific
funds transfer between two entities. It is designed to provide real-time insight into whether a transaction should be
allowed, blocked, or escalated for review based on known risk indicators.

To perform a transaction risk evaluation, send a POST request with details about the sender, receiver, and transaction
amount. The system returns a structured response containing:

* **Risk Score** – A floating-point value between `0` and `1` that reflects the probability that the transaction will
  succeed without issues. A lower score indicates higher risk; a higher score suggests a safer transaction.
* **Validity Expiration** – A UTC timestamp that indicates how long the evaluation remains valid before it should be
  refreshed.

This allows you to implement programmatic decisioning logic in your payment flows, enabling smarter and safer processing
based on risk posture.

For full request and response examples, see the [Transaction Intelligence API reference](https://risk-api.grailpay.com/spec/#/Transaction%20Risk%20Score/post_v1_transactions_score_ar).

***

## Usage Recommendations

* Run Transaction Intelligence on every ACH transfer to detect elevated fraud or return risks in advance.
* Use the `risk_score` as part of your transaction approval logic—e.g., auto-block transactions below a certain threshold
  or trigger manual review.
* Cache and store the `validity_expiration` timestamp to avoid unnecessary revalidation for repeated transactions within
  a short timeframe.
* For best results, ensure that all identity and transaction metadata is as complete and accurate as possible.

***

## Questions?

If you're encountering any issues, please reach out to [support@grailpay.com](mailto:support@grailpay.com).

***