Grace is in early access and available to selected accounts. To request access, contact your Gr4vy account manager.
- “What was my authorization rate last month, by scheme?”
- “Why did declines go up last week?”
- “Which Flow rules declined anything this week?”
- “How often does a second attempt succeed?”
- “What is network tokenization, and should I turn it on?”
What Grace knows about
Grace grounds its responses in three connected data sources.
Because Grace runs on its own page, it can’t see the filters or period set on other dashboard pages. Include the period and filters you want in your question.
What you can break down and filter by
Grace can group or filter your payment data by most transaction attributes, alone or in combination. These include:- Routing: the connection a payment went to, the provider behind it, and the Flow rule that routed it.
- Outcome: the transaction status, whether a payment was ever authorized, declined, failed, captured, voided, or refunded, the Gr4vy error code, and the raw response code from the payment service.
- Card: scheme, issuer, card type (credit, debit, or prepaid), bank identification number (BIN), and issuing country.
- Payment: method, how the payment details arrived (for example a card number, a stored card, or a network token), country, currency, and amount bands.
- Repeat payments: payment source (such as e-commerce, recurring, or card on file), whether the merchant initiated it, and whether it reused a stored credential.
- 3-D Secure: whether it was attempted, how far it got, whether the buyer was challenged, the authentication outcome, and whether liability shifted.
How Grace answers
Grace keeps answers short because they appear in a narrow panel. A typical answer has these parts:- The answer itself, with the period and filters it used folded into the sentence.
- A table or chart when the result has more than a figure or two. Charts are drawn from the same results as the tables, so a value read off a chart always matches its table.
- Grace’s interpretation, in a separate paragraph that starts with My read: in bold. Everything above that line is data. Everything after it is Grace’s judgment, which can draw on general payments knowledge.
Every rate states its basis
A rate depends on what it’s divided by. Grace always tells you. If you ask for your authorization rate with no qualifier, Grace gives two figures:- Every processed payment. Authorized payments out of every payment that was processed.
- Payments that reached a payment service. Authorized payments out of only those payments that reached a payment service. This leaves out payments your own Flow decline rules stopped first.
Estimates are labeled
When you ask what a change might do, Grace can give an estimate based on figures from the same answer. An estimate always names its inputs and its assumption, and is called an estimate. For example: “Estimate: roughly 400 more approved payments a week, if the 1,200 soft declines above recover at the 34% retry success rate above.” Estimates never appear in a table or chart.Recommendations
Grace can recommend configuration changes, such as a routing rule or a retry setting. Before it does, it reads your current configuration so it doesn’t suggest something you already have. It names the Gr4vy feature and the documentation page that describes it. Grace recommends, but it never changes your configuration. You make any change yourself in the dashboard.Get the most out of Grace
Name the period. Grace reads phrases like “last week,” “this month,” and “yesterday” as calendar periods in UTC, with weeks starting on Monday. For a rolling window, ask for “the last 7 days” instead. If your question leaves the period open and it matters, Grace asks, usually with a suggestion. Start broad, then drill in. Grace remembers the conversation, so follow-ups like “and by issuer?” or “only for Visa” build on the previous answer. A good investigation often goes from a total, to a breakdown, to a filtered breakdown. Ask why. “Why did my authorization rate drop last week compared to the week before?” makes Grace compare the two periods and show which connection, scheme, country, or other attribute accounts for the change. Specify the filters. Grace doesn’t pick up filters from other dashboard pages. Include the period and filters you want Grace to use in your question. Check whether a rule change explains a shift. Ask “did my authorization rate move when my routing rules changed last month?” and Grace lines up the weekly rate against the dates your Flow rules were edited. Ask about a single transaction. Give Grace a transaction ID and ask “why did this decline?” to see its details and the reason. Ask what to do next. Once Grace has shown you a problem, ask what it recommends. Its recommendations are better when it has already pulled the relevant figures in the same conversation. Ask how a figure was calculated. If you’re unsure what a number counts, ask. Grace can explain the basis, window, and filters behind any figure it reported.Comparing Grace with the dashboard
Grace computes its figures independently, so a number from Grace can differ from the number on an insights page. When you ask Grace about a difference, it explains it from the basis, period, and filters it used. Common causes are:- The basis. The Authorizations page excludes payments declined by Flow rules and payments that failed. Grace’s “every processed payment” figure includes them.
- The period. Grace treats “last week” as a calendar week in UTC, where a dashboard page may show a rolling window.
- Recent data. Grace’s data covers up to the start of the current hour. Early in an hour, some dashboard pages can include up to 30 minutes of payments that Grace can’t see yet.
- Rounding. Grace reports rates to one decimal place.
Conversations
Grace answers within one conversation at a time. A conversation resets, with a divider in the panel, when:- You select Start a new conversation.
- You’ve been idle for 30 minutes.
- You switch to a different merchant account.
- Your dashboard access is reduced.
Limitations
Grace can be wrong. Check any figure you plan to act on, and ask Grace how it calculated anything that looks off. Grace can’t:- Change anything. Grace reads your data and configuration and makes recommendations. It can’t create rules, edit connections, refund payments, or take any other action.
- Report on the current, incomplete hour. Grace’s payment data runs up to the start of the current hour, so it can’t tell you about the last few minutes.
- Report on chargebacks or disputes. This data isn’t available to Grace.
- Report anti-fraud decisions. Grace can’t break figures down by anti-fraud outcome.
- Analyze buyers. Grace can’t identify repeat buyers, compare new and returning buyers, or build cohorts.
- Break refunded amounts down. Grace can give a total refund volume, a refund rate, and how many payments were refunded by any attribute, but not refunded amounts by attribute.
- Add up different currencies. Grace reports each currency separately rather than combining them.
- Answer across several merchant accounts at once. Grace answers for the merchant account you have open.
- Show past connection settings. Grace reads your connections and checkout options as they are now. For Flow rules it can also list every saved change over a period, but not past versions of other settings.
- Help with topics unrelated to payments. Grace declines these and says what it can help with.
Data and privacy
Grace sees only what you can see. Grace acts as you, using your own dashboard sign-in and permissions. It can’t read data from a merchant account you don’t have access to, and it can’t show buyer details your role doesn’t allow you to see. If Grace needs a permission you don’t have, it tells you. Card numbers are blocked. If your message looks like it contains a card number, Grace doesn’t send it. Remove the number and ask again, for example by using the transaction ID instead. Your data isn’t used to train AI models. Your questions, Grace’s answers, and your payment data aren’t used for model training. Questions and answers are kept for 30 days. Gr4vy keeps a record of each question, the queries Grace ran, and the answer, so that Gr4vy support can investigate problems. These records stay in your own Gr4vy instance and region, don’t include copies of your transaction data, and are deleted after 30 days. Access to them is limited to Gr4vy staff and every read is logged.In a sandbox environment, Grace answers from your sandbox test data. Those figures say nothing about your real payments.