Updates & Announcements

​

Slack integration test

This is a test update meant to test out Slack integration.

​

Changes to transactionCancelled event in Embed

Gr4vy will be changing the payload for the transactionCancelled event raised by Embed to contain more data. This change will roll out to all merchants during the regular release cycle.

​

Background

Gr4vy Embed has an event handler called onEvent(). This parameter allows to listen to transactionCancelled events, which are raised when the Apple Pay / Google Pay payment sheets are dismissed.

setup({
  onEvent: (name, data) => {
    if(name === "transactionCancelled") {
      // inspect data
    }
  }
})

Currently, these events include a data payload that is a string.

"Apple Pay: Session cancelled"

This is inconsistent with other payloads where data is an object.

​

Changes

With this change, the new data payload will return an object instead of a string.

{
  "type": "cancellation",
  "method": "apple_pay",
  "message": "Session cancelled",
}

​

Impact

Please check if you are expecting the data property to be a string. For example, your code might perform a check to see if data === 'Apple Pay: Session cancelled'.

Instead, please check any of the new object’s properties, for example data.method === 'applepay' && data.type === 'cancellation'.

​

Affirm

We have added support a direct connection to Affirm.

Affirm is a “buy now, pay later” service that allows consumers to purchase items and split the cost into a series of installments. Offered at the checkout of numerous retailers, it provides shoppers with short-term, often interest-free payment plans, or longer-term loans for larger purchases that may carry interest. This model serves as an alternative to traditional credit cards, allowing for immediate purchase while managing payments over time, with Affirm paying the merchant upfront and assuming the repayment risk.

​

New SDKs for C#, Go, Java, PHP, Python, and TypeScript

We’re thrilled to announce a significant milestone for our developer experience: the launch of a full suite of new server-side SDKs, now available for Java, TypeScript, Python, Go, C#, and PHP.

This is a huge step forward in making integrations with Gr4vy faster, more reliable, and more consistent. These SDKs are automatically generated and updated, which marks a fundamental shift in how we build and maintain them.

​

✨ Major Documentation Enhancements

To support the new SDKs, we have launched a comprehensive update to our public documentation.

Key highlights include:

• SDK Code Samples on Every Endpoint: Every API reference page now features ready-to-use code samples for all six new SDKs, making it easier than ever for developers to get started.
• Refreshed Look & Feel: The documentation now features a cleaner navigation and improved structure. Guides have been reorganized into a new dashboard tab, and API-specific pages are now located directly under the API Reference section for better accessibility.
• AI-Powered Assistance: We have integrated support for ChatGPT, Claude, and other LLMs on every page, enabling developers to ask questions and receive instant help.
• Interactive API Playground: The Mintlify-powered API playground is now available, allowing users to make live API calls directly from the documentation.

​

Split Routing Conditions

Gr4vy now supports an additional mechanism for A/B testing through Flow. We have introduced a new Flow condition that enables merchants to split traffic between rules based on a configurable percentage.

With this new condition, merchants can route only a specified percentage of traffic to a rule, with unmatched traffic cascading to subsequent rules in the list.

​

FAQ

• What happens if the rule has other conditions as well? The rule will only trigger if all other conditions are also met. For example, a 20% condition will route 20% of the traffic that matches all other criteria.
• Can I chain multiple Flow rules with this new condition? Yes, you can chain multiple Flow rules with percentage-based routing. For instance, if you have rule A and rule B, each with a 20% condition, rule B will apply to 20% of the remaining 80% that did not match rule A. In other words (assuming no other rules or conditions):
  • Rule A: 20% of traffic matches
  • Rule B: 20% of the remaining 80% = 16% of traffic matches
  • Remaining: 64% of traffic continues to other rules or follows default behavior

​

Worldpay: WPG

Worldpay WPG is now available as a card connector. Worldpay’s Worldwide Payment Gateway is our second integration with Worldpay after VAP. While VAP focuses on the US market, WPG is available globally and supports processing in any currency, local debit schemes, and more. This connector was developed in close collaboration with Worldpay and is fully certified.

​

Nuvei: iDEAL

We have added support for iDEAL via Nuvei.

iDEAL is the leading online payment method in the Netherlands, enabling consumers to pay for purchases through direct online transfers from their bank accounts. At checkout, users are securely redirected to their online banking environment to authorize the transaction, providing merchants with real-time payment confirmation. This process is highly secure, as no financial details are shared.

Nuvei is a global payment technology company offering a comprehensive suite of payment solutions. Its platform enables merchants to accept a wide variety of payment methods, manage payouts, and utilize services such as card issuing, risk management, and analytics. Nuvei helps businesses connect with customers across more than 200 markets through a single integration.

​

Real-time Account Updater

Gr4vy now has support for a real-time account (RTAU) updater for Visa and Mastercard cards.

An Account Updater provides a card inquiry service at the schemes. It’s an API that can be called to retrieve an update to a card. We previously had implemented the Batch Account updater (BAU), which allows cards to be scheduled for updates which then arrive a few days later. This worked but was not cost-effective for us or our merchants.

A real-time account update instead provides immediate updates from the issuers on the validity and existence of cards. It functions the same way as batch account updater, in the sense that the same responses are provided, it is however real time and functions as a great tool to recover transactions. As part of this update we also made a slew of extra enhancements to ensure we don’t retry cards previously marked as dead, to both the RTAU and BAU.

​

PayPal Settlement Reporting

Gr4vy now has support for settlement reporting through PayPal.

Settlement reporting provides merchants with detailed information about the settlement of their PayPal transactions. This includes data on when funds are transferred, the amounts settled, and any associated fees or adjustments. With this feature, merchants can more easily reconcile their PayPal transactions, track settlement timelines, and ensure accurate financial reporting.

To enable PayPal settlement reporting or to learn more about how to access these reports, please refer to our PayPal settlement documentation or contact your Gr4vy support representative.

​

Transaction Request Logging

Gr4vy now displays the original HTTP request body and headers on the dashboard, as well as the corresponding API response for each transaction.

This enhancement enables merchants to gain deeper insight into the exact payloads sent to our API and the responses returned. With this feature, platforms can more effectively support their customers, making it easier to diagnose and resolve any issues that may arise during API integration.

The logging includes API calls for the original authorization or sale request, as well as any subsequent capture, void, or refund operations. It does not include events that were not accepted, such as those resulting from invalid JWTs, invalid requests (e.g., missing parameters), or insufficient permissions. These 4XX errors can be found in our API logs.

​

Webhook Signatures

Gr4vy now supports signatures for webhooks. These signatures enable verification of the authenticity and integrity of received webhook notifications. By validating the webhook signature, merchants can ensure that notifications originate from Gr4vy and have not been tampered with by unauthorized parties.

For further guidance on secrets management, signature verification, and signature rotation, please refer to the documentation.

​

Numeric metadata conditions in Flow

Gr4vy now supports numeric metadata conditions in Flow. This enhancement enables merchants to pass numeric metadata values via the transaction API and perform numeric comparisons to drive logic within Flow.

Previously, only string comparisons of metadata were possible. To address this limitation, a new Flow condition has been introduced that allows for numeric comparisons against metadata values. Please note that while the API continues to accept only string values, Flow will automatically convert these values to numeric form for comparison purposes.

​

OXXO Pay Connector

Gr4vy now offers support for OXXO Pay, a widely used voucher-based payment method in Mexico.

OXXO Pay enables customers to complete online purchases by generating a unique reference code, which can be used to pay in cash at any OXXO convenience store. Upon selecting OXXO Pay at checkout, customers receive this reference code and instructions for payment. Since payments are made in person, there is an inherent processing delay until the payment is confirmed by OXXO and the funds are settled.

Merchants can leverage the default hosted payment flow provided by Gr4vy, which displays the reference code and payment instructions to the customer. Alternatively, merchants may configure a custom approval URL to present their own branded barcode or reference page.

OXXO Pay is an important payment option for merchants seeking to reach consumers in Mexico who prefer or require cash-based payment methods. For further details on enabling and configuring OXXO Pay, please refer to the OXXO Pay documentation.

​

Merchant Advice Codes

Gr4vy now supports Merchant Advice Codes (MACs), a feature introduced by Mastercard to provide merchants with greater insight into declined transactions. MACs are two-digit codes included in transaction responses that indicate the specific reason for a decline and offer recommendations regarding subsequent actions, such as whether a transaction may be retried.

For example, a MAC of "01" signifies “New account information available.” Payment service providers (PSPs) pass this code through in the transaction response, and Gr4vy now reads and returns this value to merchants via our API. This enhancement is also planned for integration with our Real-Time Account Updater (RTAU) functionality.

Merchant Advice Codes are now available through both the API and the dashboard, and have been enabled for Cybersource, Mastercard, Checkout, Adyen, and Stripe connections.

​

Latitude and Gem Interest Free

Gr4vy has launched new connectors to support Latitude Interest Free (Australia) and Gem Interest Free (New Zealand). These integrations enable merchants to offer eligible Latitude and Gem cardholders the ability to split purchases into interest-free instalments at checkout.

By supporting these payment options, merchants can provide greater flexibility to consumers, potentially increasing conversion rates and average order values. For more information on enabling Latitude or Gem Interest Free, please refer to the relevant connector documentation or contact your Gr4vy support representative.

​

Worldline TravelHub Card

Gr4vy is pleased to announce the release of our connector for Worldline TravelHub, a payment gateway specifically designed for the travel industry. Worldline TravelHub provides access to a broad range of payment methods, including both card payments and numerous local and alternative payment methods (LPMs and APMs). This gateway is generally available to merchants operating within the travel sector.

With this new connector, Gr4vy now supports card payments through Worldline TravelHub, in addition to previously supported payment methods such as iDEAL and Sofort. The connector offers a comprehensive set of features, including direct capture, support for both partial and full refunds, airline data fields, cart itemization, and more.

This enhancement was developed in response to merchant requests, including those from Corendon, and is intended to provide greater flexibility and functionality for travel merchants processing payments globally.

For further information on enabling and configuring the Worldline TravelHub Card connector, please refer to the official documentation or contact your Gr4vy support representative.