Nuvei - Bank account (ACH)

Process ACH payments from bank accounts stored in Gr4vy through Nuvei.

Nuvei is a global payment provider that offers comprehensive payment processing solutions across multiple payment methods and regions.

The Nuvei bank account connector processes ACH payments from bank account details you submit via the API, which Gr4vy stores. See Bank accounts for an overview of the 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

​

Capabilities

​

Supported countries

​

Supported currencies

​

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.

C#

var transaction = await client.Transactions.CreateAsync(
  transactionCreate: new TransactionCreate()
  {
    Amount = 1299,
    Currency = "USD",
    Country = "US",
    Intent = "capture",
    PaymentMethod = TransactionCreatePaymentMethod.CreateACHBankPaymentMethodCreate(
      new ACHBankPaymentMethodCreate()
      {
        AccountNumber = "1234567890",
        RoutingNumber = "011000138",
        AccountType = "checking",
        AccountHolder = new BankAccountHolder()
        {
          FirstName = "John",
          LastName = "Doe"
        }
      }
    ),
    Buyer = new GuestBuyer()
    {
      BillingDetails = new BillingDetails()
      {
        FirstName = "John",
        LastName = "Doe"
      }
    },
    PaymentServiceId = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
);

​

ACH returns

When Nuvei reports a failed ACH payment or refund through a webhook, the NACHA return code prefixes the raw_response_description on the transaction or refund, for example R01-Insufficient funds. Several return codes share the same description, so use the code to tell them apart. The return code is only available from these webhooks, so it isn’t set when the failure comes back in the API response.

​

Testing

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