Accepted providers

VINR accepts four meal voucher providers. Each appears as a distinct method value in the VINR API and produces a separate settlement line in reconciliation.

Provider referenceAskCopy

Identifying a meal voucher paymentAskCopy

After a meal voucher payment is completed, the payment.method field on the payment object contains the provider-specific value:

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

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

const payment = await vinr.payments.retrieve('pay_ABC123');

console.log(payment.method);
// → "meal_voucher_sodexo"

In payment_method_details, the meal_voucher object includes:

{
  "meal_voucher": {
    "provider": "sodexo",
    "last4": "4321"
  }
}

Settlement timelinesAskCopy

Meal voucher settlements follow provider-specific timelines, which differ from standard card settlement:

Meal voucher settlements appear as separate line items in your VINR reconciliation report, labelled by provider. See reconciliation for details on reading the report.

Null balance handlingAskCopy

When a customer's voucher balance is less than the payment amount, VINR returns an error code of voucher_balance_insufficient. You must implement split-tender handling to charge the remaining amount to a second payment method. See In-person & online integration for the split-tender flow.

See alsoAskCopy