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

# Voucher:payment

`POST /v1/vouchers/payment`

## Request

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

This endpoint initiates a voucher (gift card) payment in the Transaction Gateway Unit API. It allows your system to process a payment using a voucher as the payment method in a direct request. <br /><br /> Use this API when you want to charge a voucher for an order amount and begin a payment transaction using voucher credentials (e.g., card number and PIN). This is part of the voucher & gift card payment flow, enabling you to handle voucher-based payments directly through your backend integration.

## Request body

- VoucherPaymentInput (unresolved $ref)

## Response `201`

Captured a voucher payment.

- VoucherPaymentOutput
  - `id` string
  - `orderId` string
  - `description` string, nullable
  - `reference` string, nullable
  - `manualTransferCode` string
  - `createdAt` string, date-time
  - `expiresAt` string, date-time
  - `amount` VoucherPaymentOutputAmount
    - `value` integer
    - `currency` string
  - `integration` VoucherPaymentOutputIntegration
    - `test` boolean
    - `pointOfInteraction` 'ON_THE_MOVE' | 'ECOMMERCE' | 'IN_PERSON' | 'INVOICE' | 'DEBT_COLLECTION' | 'FUNDING' | 'PAYMENT_REQUEST' | 'RECURRING' | 'UNATTENDED' | 'MOTO' | 'PAYOUT' | 'null', nullable
  - `links` VoucherPaymentOutputLinks
    - `status` string
    - `redirect` 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)
