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: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.
- Risk Score – A floating-point value between
0and1that 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.
Usage Recommendations
- Run Transaction Intelligence on every ACH transfer to detect elevated fraud or return risks in advance.
- Use the
risk_scoreas part of your transaction approval logic—e.g., auto-block transactions below a certain threshold or trigger manual review. - Cache and store the
validity_expirationtimestamp 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.
