---
title: "Voucher:info"
method: POST
path: "/v1/vouchers/info"
tags: ["Voucher"]
---

# Voucher:info

`POST /v1/vouchers/info`

## Request

- Base URL: `https://connect.pay.nl`
- URL: `https://connect.pay.nl/v1/vouchers/info`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

This endpoint retrieves information about a voucher (gift card). <br /><br /> Use this API when you want to validate a voucher and check the amount, expiry date and brand information of the voucher.

## Request body

- VoucherInfoInput
  - `serviceId` string, nullable: Unique service location (SL-code) required when authenticating with Merchant API Tokens (AT-code + Token)
  - `integration` VoucherInfoInputIntegration
    - `test` boolean, nullable
    - `pointOfInteraction` 'ON_THE_MOVE' | 'ECOMMERCE' | 'IN_PERSON' | 'INVOICE' | 'DEBT_COLLECTION' | 'FUNDING' | 'PAYMENT_REQUEST' | 'RECURRING' | 'UNATTENDED' | 'MOTO' | 'PAYOUT' | 'null', nullable
  - `voucher` VoucherInfoInputVoucher, required
    - `number` string, required
    - `pincode` string, nullable

## Response `200`

Retrieved card details for a voucher

- VoucherInfoOutput
  - `integration` VoucherInfoOutputIntegration
    - `test` boolean
    - `pointOfInteraction` 'ON_THE_MOVE' | 'ECOMMERCE' | 'IN_PERSON' | 'INVOICE' | 'DEBT_COLLECTION' | 'FUNDING' | 'PAYMENT_REQUEST' | 'RECURRING' | 'UNATTENDED' | 'MOTO' | 'PAYOUT'
  - `voucher` VoucherInfoOutputVoucher
    - `amount` VoucherInfoOutputAmount
      - `value` integer
      - `currency` string
    - `expiresAt` string, date-time, nullable
    - `brand` VoucherInfoOutputVoucherBrand
      - `id` integer
      - `name` string
      - `iconUrl` string

## Other responses

- `400`: Invalid input
- `422`: Unprocessable entity

---

[API](https://skmtc.dev/pay/apis/pay-transaction-gateway-unit-api.md) - [All operations](https://skmtc.dev/pay/apis/pay-transaction-gateway-unit-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pay/apis/pay-transaction-gateway-unit-api/revisions/2bc260c7bdfc?raw)