Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.gr4vy.com/llms.txt

Use this file to discover all available pages before exploring further.

Nuvei is a global payment provider that offers comprehensive payment processing solutions across multiple payment methods and regions. The Nuvei bank connector enables you to process ACH bank payments by submitting bank account details directly via the API. See Direct bank payments for an overview of the direct integration flow.

​
Setup

Please follow the common Nuvei instructions to get set up with Nuvei. After setting up your Nuvei account, make sure ACH bank payments are enabled as a payment method on your account. Nuvei requires the following fields to be collected during checkout for bank transactions:
  • First name and last name
  • Billing country

​
Features

Nuvei bank payments support the following features:
  • Direct capture - Capture funds immediately at the time of the transaction
  • Refunds - Refund transactions in full or in part
  • Partial refunds - Refund a portion of the original transaction amount
  • Transaction synchronization - Keep payment statuses synchronized with Nuvei
  • Idempotency - Gr4vy generates and sends a clientRequestId with every request to Nuvei. To enable idempotency, contact your Nuvei Account Manager to make clientRequestId mandatory on your account

​
Supported countries

Nuvei supports transactions from buyers in US.

​
Supported currencies

Nuvei supports processing payments in USD.

​
Limitations

The following features are not supported by this connector:
  • Delayed capture - Authorization and capture must happen together
  • Partial capture - Cannot capture a portion of the authorized amount
  • Void - Cannot cancel transactions once initiated
  • Payment method tokenization - Cannot store payment methods for recurring transactions
  • Zero auth - Zero-dollar verification transactions are not supported
  • Settlement reporting - Settlement reporting is not available

​
Integration

To process a bank payment via Nuvei, submit bank account details directly with payment_method.method set to bank and payment_method.scheme set to ach. 
var transaction = await client.Transactions.CreateAsync(
  transactionCreate: new TransactionCreate()
  {
    Amount = 1299,
    Currency = "USD",
    Country = "US",
    Intent = TransactionCreate.IntentEnum.Capture,
    PaymentMethod = TransactionCreatePaymentMethod.CreateACHBankPaymentMethodCreate(
      new ACHBankPaymentMethodCreate()
      {
        Method = ACHBankPaymentMethodCreate.MethodEnum.Bank,
        Scheme = ACHBankPaymentMethodCreate.SchemeEnum.Ach,
        AccountNumber = "1234567890",
        RoutingNumber = "011000138",
        AccountType = ACHBankPaymentMethodCreate.AccountTypeEnum.Checking,
        AccountHolder = new BankAccountHolder()
        {
          FirstName = "John",
          LastName = "Doe"
        }
      }
    ),
    Buyer = new GuestBuyer()
    {
      BillingDetails = new BillingDetails()
      {
        FirstName = "John",
        LastName = "Doe"
      }
    },
    PaymentServiceId = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
);

​
Testing

Refer to Nuvei’s documentation for available test account numbers and ACH test scenarios in the sandbox environment.