Skip to main content

​
Setup

Contact Ecommpay to obtain sandbox credentials for your region. Then, in the Gr4vy dashboard, add your Ecommpay connection using your Project ID and Secret Key.

​
How requests are processed

Ecommpay processes payments asynchronously. It immediately acknowledges the request, then finishes the transaction and reports the outcome through callbacks. To provide a synchronous experience, Gr4vy sends the initial call and then automatically checks Ecommpay for status updates. Ecommpay usually needs a few seconds to complete a request. After the initial call, Gr4vy polls for status until the transaction leaves processing, sending up to three checks at roughly the 1, 3, and 5 second marks. Webhooks are also monitored as a fail-safe. Because of this, a single Ecommpay transaction in Gr4vy shows as multiple API requests plus a webhook event on the dashboard.

​
Required fields

  • Billing details must include a valid phone number; including the email in billing details is also strongly recommended.

​
Limitations

  • CVV Requirements: A CVV is required for all card payments, with the following exceptions:
    • Stored Credentials: When a card is tokenized during an initial transaction and subsequently invoked for follow-up payments.
    • Merchant-Initiated Transactions (MIT): Recurring payments or installments where the initial transaction was completed by the customer using a CVV.
  • Closed-Loop Provider: Ecommpay can only process or recognize card tokens that were originally generated through their own services.

​
Tokenization callbacks

Your Ecommpay contact must enable tokenization for your project. After it is enabled, set up a dedicated tokenization callback. Gr4vy automatically handles Ecommpay’s transaction webhooks, but tokenization results use a separate callback. To configure the tokenization callback:
  1. In the Ecommpay dashboard, go to Settings -> Callbacks.
  2. Create a new callback using the synchronization URL from your Ecommpay connector settings in the Gr4vy dashboard.
  3. Set the callback result type to “tokenize”.

​
Payouts (travel MCC)

The Gr4vy integration supports payouts for travel-related merchant category codes.