Add payment methods

Enable and configure payment methods for your VINR integration.

View as MarkdownInstall skills

VINR supports a wide range of payment methods out of the box. Which methods you offer — and how you configure them — directly affects conversion across different markets and customer segments.

Payment method categoriesAsk

CategoryExamplesRegionsSettlement
CardsVisa, Mastercard, AmexGlobalInstant auth
Bank debitsACH, SEPA Direct DebitUS, EU1–5 days
Bank redirectsiDEAL, Bancontact, SofortEUNear-instant
Bank transfersWire, BACSGlobal1–5 days
BNPLKlarna, Afterpay, AffirmUS, EU, AUInstant auth
Real-time paymentsPix, UPI, Faster PaymentsBR, IN, UKInstant
VouchersBoleto, OXXOBR, MXAsync (1–3 days)
WalletsApple Pay, Google Pay, LinkGlobalInstant

Dynamic payment methodsAsk

The recommended approach. VINR automatically selects the right methods for each customer's locale, currency, and device. Any new methods you enable in the Dashboard appear without code changes.

import { Vinr } from '@vinr/sdk';

const vinr = new Vinr({ secretKey: process.env.VINR_SECRET_KEY });

const payment = await vinr.payments.create({
  amount: 4900,
  currency: 'EUR',
  automaticPaymentMethods: { enabled: true },
});

Static method listAsk

Set paymentMethodTypes explicitly when you need a fixed set — for example, cards only on a B2B invoice form where local redirect methods would be confusing.

import { Vinr } from '@vinr/sdk';

const vinr = new Vinr({ secretKey: process.env.VINR_SECRET_KEY });

const payment = await vinr.payments.create({
  amount: 4900,
  currency: 'EUR',
  paymentMethodTypes: ['card'],
});

Use dynamic methods for consumer flows unless you have a specific reason to restrict the list — you get locale-appropriate methods without maintaining the array yourself.

Enabling methods in the DashboardAsk

Go to Settings → Payment methods and toggle on any method you want to offer. Some methods require extra setup before they go live:

  • ACH Direct Debit — link a bank account for payouts and accept the ACH agreement.
  • SEPA Direct Debit — complete EU creditor registration.
  • BNPL providers — each provider runs its own onboarding; VINR surfaces the approval flow inline.

Toggles take effect immediately. Newly enabled methods appear in dynamic-method flows without a code deploy.

Dynamic methods only surface methods that are both enabled in your Dashboard settings and available in the customer's country. Enabling a method globally does not mean every customer sees it — eligibility is evaluated per transaction.

In this sectionAsk

Was this page helpful?
Edit on GitHub

Last updated on

On this page